A local-first knowledge studio for rich notes, knowledge graphs, mind maps, semantic search, and AI-assisted thinking — all in your browser, no backend required.
This repository contains the redesigned DO Knowledge Studio: a Next.js 16 app that reimagines the original Vite + React SPA as a calmer, more deliberate editorial workspace. The visual language is "Editorial Paper & Saffron" — warm paper backgrounds, deep ink type, and a single saffron accent. See DESIGN.md for the full design reference.
- Next.js 16 (App Router) with React 19
- TypeScript strict mode
- Tailwind CSS 4 with
@theme inlinetoken mapping - shadcn/ui primitives (Radix UI + CVA)
- Zustand for app state
- Framer Motion for animation
- Lucide icon set
- Sonner for toast notifications
- next-themes for light/dark theming
- cmdk for the command palette
- next/font/google for Newsreader, Geist Sans, Geist Mono
| View | One-line description |
|---|---|
| Home | Dashboard with stats, recent activity, and entity-type breakdown. |
| Editor | Capture a thought, claim, or note with floating toolbar, tags, and meta. |
| Library | Browse and filter entities in a grid or list with sort and type filters. |
| Graph | Visualize relationships as an interactive SVG graph with three layouts. |
| Mind Map | Hierarchical exploration with expandable tree, depth slider, and root selector. |
| Chat | Ask your library; the assistant answers with grounded citations. |
| AI Harness | Configure LLM providers (Anthropic, OpenAI, Ollama) and chat with models. |
| TRIZ Matrix | Solve inventive contradictions via a 2-step parameter picker + principle results. |
| Export | Backup and share your knowledge as Markdown, JSON, or encrypted archive. |
bun install
bun run devThe app is served at http://localhost:3000. The dev log is tee'd to
dev.log in the project root.
Other scripts:
bun run lint # eslint
bun run build # production build
bun run start # serve the standalone production build
bun run db:push # prisma db push (if you use the prisma layer)src/
app/
globals.css # design tokens, base layer, utility classes
layout.tsx # root layout, fonts, toaster, theme provider
page.tsx # renders <AppShell />
components/
studio/
app-shell.tsx # 3-column shell: sidebar | main | right panel
topbar.tsx # responsive header with inline quick-search
sidebar.tsx # nav with grouped items + shortcuts
right-panel.tsx # contextual search / inspector / citations
command-palette.tsx
theme-provider.tsx
views/ # the 9 view components
...
ui/ # shadcn primitives (do not hand-edit)
lib/
studio/
store.ts # zustand store + selectors
types.ts # Entity, Claim, ChatMessage, ENTITY_TYPE_META
seed-data.ts # mock entities / claims / chat
utils.ts # cn() class merge
db.ts # prisma client (unused by the studio shell)
public/
favicon.svg
logo.svg
DESIGN.md # full design reference
worklog.md # build log
The full design reference — color tokens, typography, spacing, radius,
shadows, focus rings, component patterns, layout, and accessibility rules —
lives in DESIGN.md. Read it before adding new
components or touching tokens in globals.css.
- All entity data lives in the Zustand store (seeded from
src/lib/studio/seed-data.ts). There is no network call required to use the app. - The "Offline ready" badge in the topbar is a constant reminder of this promise.
- Export is the user's escape hatch — OKF v0.2 Bundle (agent-readable Markdown ZIP), Markdown, JSON, or an encrypted archive.
- The AI Harness view supports local Ollama models so the entire workflow can stay on-device.
The AI Harness integrates with OpenRouter, supporting both specific, concrete models (e.g. Claude 3.5 Sonnet) and OpenRouter's first-class Routers as selectable engines.
Routers expose higher-level, automated behaviors that optimize speed, cost, or response quality, making them incredibly useful for agentic, evaluation, or high-throughput workflows.
| Router | Behavior & Recommended Workflow |
|---|---|
Auto Router (openrouter/auto) | Dynamically selects the best model for your prompt. Recommended for general reasoning or tasks with highly variable complexity. |
Free Models Router (openrouter/free) | Cost-optimized routing that stays 100% free. Recommended for cost-sensitive experiments and high-volume local-first playground queries. |
Fusion Router (openrouter/fusion) | Runs multi-model deliberation and merges responses with a judge panel. Recommended for deep analysis, synthesis, or highly creative tasks. |
Pareto Router (openrouter/pareto) | Scores models based on speed/cost vs quality tradeoffs. Recommended for high-speed coding and instruction-following agent tasks. |
Latest Model Resolution (openrouter/flavor-latest) | Automatically resolves family-latest style slugs so you are always using the absolute latest model in a specific lineage. |
When calling OpenRouter programmatically, you can pass either a concrete model slug or a router target object:
// Example 1: Passing a Router SlugawaitsendChat({provider: 'openrouter',model: 'openrouter/auto',apiKey: 'YOUR_API_KEY',messages: [...]})// Example 2: Passing an OpenRouterTarget ObjectawaitsendChat({provider: 'openrouter',model: {kind: 'router',slug: 'openrouter/fusion',display_name: 'Fusion Router'},apiKey: 'YOUR_API_KEY',messages: [...]})Internal project. See the original repository for licensing context.