Raqq

Building a local-first study workspace for source integration, durable notes, and spaced repetition.

Raqq People object with linked study context and properties
Learning workspace2026

Intro

Raqq is a local-first study workspace for serious students of knowledge. It began with a problem that gets worse over time: books, source texts, people, concepts, notes, and past reflections become harder to keep connected as a body of study grows.

Saving another note is easy. Preserving its context is harder. You need to know what you read, where an idea came from, what it connects to, why it mattered, and when it should return for review.

Raqq is still in development. The goal for launch is a durable workspace that connects authored notes to source material and turns important knowledge into scheduled review.

My role

I am designing and building Raqq end to end as a desktop product.

  • Product direction and information architecture
  • Interface and interaction design
  • Desktop application development with Tauri, React, and Rust
  • Local persistence and SQLite data modelling
  • Reading, note-taking, relationship, and review workflows

The current work is focused on the local reading and note-taking foundation. Source integration and spaced repetition remain launch requirements, not finished claims.

Solution

Raqq treats study material as connected objects rather than a folder of interchangeable documents. Notes, books, pathways, people, poems, reflections, and sources each retain their own structure while sharing a common relationship model.

Raqq home dashboard showing flashcard review and recently updated study items
The home view brings review and recently updated study material into one starting point.

The note editor gives authored study material a focused reading surface. Content stays readable as Markdown on disk instead of being locked inside an account or proprietary cloud database.

Raqq note editor showing The Importance of Aqeedah
Notes keep the work of studying readable and local.

Notes can be revisited as structured study material rather than disappearing into a generic document list.

Raqq note editor showing The Reality and Objectives of Aqeedah
Long-form notes remain part of the same connected workspace.

Reading is part of the same workspace. The book view keeps source material close to the notes and properties that give it context.

Raqq book reader showing The Disease and the CureRaqq book reader showing properties for The Disease and the Cure
The reading view and object properties keep source material in context.

Process

I started by separating durable study needs from the conventions of general note-taking apps. A serious study workspace needs provenance, relationships, and review. Capture alone is not enough.

That led to a desktop-first, local architecture. Authored content lives as Markdown on disk. SQLite mirrors metadata for fast search, properties, and relationships, while a Rust core handles the storage layer. There are no accounts, cloud sync loops, or telemetry.

The sequence matters. I am stabilising reading, writing, object types, and local persistence before adding the complete source-integration and spaced-repetition workflows. Review only becomes useful when the material underneath it has reliable context.

Lessons

Local-first is a product constraint, not a storage preference. Keeping Markdown readable on disk affects identity, metadata, search, relationships, and every workflow built on top of them.

Study tools also need stronger object boundaries than general note apps. A person, book, reflection, and source may all contain text, but treating them as the same document removes useful context.

The final lesson is about sequence. Spaced repetition is tempting to build early because it is visible and concrete. It only becomes durable after source material, notes, and relationships are stable enough to support it.