| title | README |
|---|---|
| created | 2026-03-24 18:26:59 +0000 |
A modern, local-first note-taking application built with Tauri and React. Features Obsidian-style vault management, Markdown editing with live preview, knowledge graph linking, and visual graph exploration.
- Local Vault System - Use any folder as your notes vault
- Markdown Editor - Full GFM support with split view and live preview
- Syntax Highlighting - Code blocks with language detection
- Auto-Save - Notes save automatically after editing
- Wikilinks - Link notes with
[[Note Title]]syntax - Backlinks Panel - See all notes linking to the current note
- Tags - Organize with
#tagsthroughout content - Graph View - Visual exploration of note connections
- Full-Text Search - Instant search across all notes
- Tag Filtering - Filter notes by tags
- Sorting - Sort by modified date, created date, or title
- File Explorer - Sidebar with folder tree navigation
- Native Window - Uses OS native title bar and controls
- Cross-Platform - Works on Windows, macOS, and Linux
| Layer | Technology |
|---|---|
| Desktop | Tauri 2.x (Rust) |
| Frontend | React 18 + TypeScript |
| Build | Vite |
| State | Zustand |
| Routing | React Router 6 |
| Markdown | react-markdown + remark-gfm |
| Syntax | react-syntax-highlighter |
| Monorepo | Turborepo |
notes-app/
├── apps/
│ └── desktop/ # Tauri desktop application
│ ├── src/
│ │ ├── components/ # React components
│ │ ├── pages/ # Page components
│ │ ├── store/ # Zustand stores
│ │ ├── styles/ # CSS styles
│ │ ├── utils/ # Utility functions
│ │ └── main.tsx # App entry point
│ └── src-tauri/ # Rust backend
├── packages/
│ ├── shared/ # Shared TypeScript types
│ └── ui/ # Shared UI components
├── docs/ # Phase documentation
│ ├── PHASE1.md # Vault System
│ ├── PHASE2.md # Markdown Editor
│ ├── PHASE3.md # Linking & Backlinks
│ ├── PHASE4.md # Search & Tags
│ └── PHASE5.md # Graph View
└── package.json # Root workspace config
- Node.js 18+
- Rust toolchain
- npm or pnpm
# Install dependencies
npm install
# Run in development mode
npm run tauri dev| Command | Description |
|---|---|
npm run tauri dev | Run desktop app in development |
npm run tauri build | Build desktop app for production |
npm run typecheck | Run TypeScript type checking |
npm run lint | Run ESLint |
- Launch the app
- Click "Open Vault Folder"
- Select any folder on your computer
- Your vault is ready!
- Click "New Note" or press
⌘N - Write in Markdown with live preview
- Notes auto-save after you stop typing
Use wikilink syntax to connect notes:
This relates to [[Another Note]]
Add tags anywhere in your notes:
#important #project
Click the graph icon in the top bar to visualize how your notes connect.
| Phase | Status | Description |
|---|---|---|
| Phase 1 | ✅ | Local Vault System |
| Phase 2 | ✅ | Markdown Editor |
| Phase 3 | ✅ | Linking & Knowledge Graph |
| Phase 4 | ✅ | Search & Tags |
| Phase 5 | ✅ | Graph View |
| Phase 6 | 🚧 | Future: Sync & Collaboration |
| Phase 7 | 🚧 | Future: Plugin System |
See docs/ directory for detailed phase documentation.
Settings are stored in the app data directory:
- Windows:
%APPDATA%/Notes App/ - macOS:
~/Library/Application Support/Notes App/ - Linux:
~/.config/Notes App/
Notes are stored as .md files with YAML frontmatter:
---
title: "Note Title"created: 2026-03-24T00:00:00Z
---MIT