Crumbs by Bretzel

A self-hostable, offline-first note-taking app inspired by Google Keep. Part of the Bretzel app universe.

Quick Start

Docker (Recommended)

docker compose up -d

Open http://localhost:3000 and set your password on first visit.

Development

pnpm install
pnpm dev

Run make help to see all available commands, or use pnpm directly:

pnpm test          # Unit + E2E tests
pnpm check         # Type checking
pnpm build         # Production build

Features

• Rich notes with Markdown, checklists, image attachments, and 12 color themes
• Organize with #tags, pinning, archive, and trash
• Full-text search across titles, content, and tags
• PWA — installable, works offline via IndexedDB + LWW CRDT sync
• Single-user password auth (Argon2)
• Docker deployment with a single command

See docs/FEATURES.md for detailed feature documentation.

Tech Stack

Layer	Technology
Framework	SvelteKit 2 (Svelte 5 runes)
Language	TypeScript (strict)
UI	Tailwind CSS 4
Database	SQLite (better-sqlite3) + Drizzle ORM
Client DB	IndexedDB (idb)
Sync	LWW CRDTs
Auth	Argon2 + session cookies
Testing	Vitest + Playwright
Container	Docker (multi-stage)
CI/CD	GitHub Actions

Documentation

Document	Description
Features	Detailed feature list and behavior
Architecture	Local-first sync design, tech rationale, DB schema
Deployment	Docker, Node.js, reverse proxy, backups, env vars
API	REST API reference (auto-generated)
Contributing	How to contribute
Security	Vulnerability reporting policy
Changelog	Release history

CI/CD

• CI — lint, type check, unit tests, E2E tests, Docker build on every push/PR
• Release — builds and pushes Docker image on v* tags

Configure registry via GitHub Secrets: REGISTRY_URL, REGISTRY_USER, REGISTRY_TOKEN.

License

MIT