DO Knowledge Studio
A local-first knowledge studio for rich notes, knowledge graphs, mind maps, client-side semantic search, TRIZ inventive problem-solving, and AI-assisted synthesis — all inside your browser with zero server backend required.
The visual language follows Editorial Paper & Saffron: warm paper backgrounds, crisp ink typography, and a purposeful saffron accent. See DESIGN.md for the complete design token reference.
Screenshots are generated by scripts/generate-readme-screenshots.mjs (Playwright, light/dark + desktop/mobile) so they do not go stale; see plans/206-onboarding-1064-2026-11-08.md.
Why local-first
Your notes stay in this browser (IndexedDB + a small localStorage envelope). No account, no server. Only opt-in flows leave the device: AI providers, web research, sync signaling and model downloads. Privacy details: ADR 045. Live demo: https://do-knowledge-studio.vercel.app
Key Capabilities
- Local-First & Private: The canonical corpus (notes, entities, claims, graph, mind map, links and tags) persists in browser IndexedDB through Zustand. A small localStorage envelope carries schema metadata, recovery snapshots and quarantine copies; Yjs keeps a separate collaboration replica in IndexedDB. No remote backend or database setup needed.
- Peer-to-Peer Multi-Device Sync (opt-in): Decentralized WebRTC synchronization powered by Yjs CRDTs, with QR-code room pairing, live presence and remote cursors. Joining a room is the only way library data reaches another peer.
- Client-Side Search Engine: Browser-local BM25 keyword search and embedding-based semantic retrieval. Lexical search uses a Web Worker when available, with an in-browser fallback. Semantic indexing is incremental and cached by model, preprocessing and corpus fingerprints.
- Knowledge Graph & Mind Map: Interactive SVG graph visualization with Force, Circular, and Hierarchical layouts, alongside expandable mind map tree navigation with depth filtering.
- TRIZ Contradiction Matrix: Full interactive Altshuller 39×39 contradiction matrix with 40 inventive principles to systematically resolve engineering trade-offs without compromise.
- Universal Export & Verified Backups: Export agent-readable Open Knowledge Format (OKF v0.2) ZIP bundles, password-encrypted standalone HTML readers, Markdown, JSON, HTML, DOCX, PDF, and a portable
.dksb backup with SHA-256 checksums, optional AES-256-GCM passphrase encryption and previewed restore.
- AI Assistant Harness (opt-in remote): Connect to OpenRouter, local Ollama instances, optional in-browser models, or enable web research for grounded citations and client-side tool-calling. Browser models download weights on first use; later inference can run offline while the browser retains those cached assets. OpenRouter and web research send prompts off-device.
- Accessible & Responsive: Semantic, keyboard-accessible controls, the
? shortcuts palette, mobile drawer layout, and support for prefers-reduced-motion.
Tech Stack
| Layer | Technologies |
|---|
| Framework & UI | Next.js 16 (App Router), React 19, Tailwind CSS 4 (@theme inline), shadcn/ui (Radix UI + CVA) |
| State & Storage | Zustand with a canonical IndexedDB corpus, a small localStorage metadata/recovery envelope, and IndexedDB persistence for the Yjs sync replica; Zod schema boundaries |
| Sync & CRDT | Yjs, WebRTC peer channels, tombstone tracking, three-way merge resolution |
| Search & Retrieval | BM25 keyword search in a Web Worker and in-browser embedding-based semantic retrieval |
| Animations & Icons | Framer Motion, Lucide React, Sonner toasts |
| Typography & Theme | Newsreader (serif headings), Geist Sans (body), Geist Mono (code), next-themes (Light/Dark) |
| Testing & Quality | Vitest (unit/integration), Playwright E2E, ESLint 10 |
This is the beginning of the README. Read the rest at the original. Read the full README ↗
