Introduction
This book documents the current Lapis Notes architecture as implemented in this monorepo on 19 April 2026. It is a current-state description, not a future-state design.
The repository is organized around four primary layers:
- a browser-first workspace shell in
packages/workspace - an Obsidian-like runtime and compatibility layer in
packages/api - a shared Svelte UI kit in
packages/ui - several feature and plugin packages in
packages/plugins
Use this spec to understand where behavior lives today, trace boot and data flows, and capture follow-up decisions as ADRs.
Where the codebase is incomplete or ambiguous, the pages call that out directly. The current desktop packaging is one example: checked-in build artifacts exist, but the source package shape is not yet fully represented in the workspace metadata.