Drafto

Drafto

A note-taking app with notebooks, rich text editing, and auto-save. Available as a web app, iOS + Android apps, and a macOS desktop app — all with offline support.

Live: drafto.eu

Features

• Notebooks — flat list of notebooks to organize notes
• Notes — rich text with auto-save (BlockNote on web, TenTap on mobile/desktop)
• Offline support — mobile and desktop use WatermelonDB locally and sync to Supabase when online
• Authentication — email/password with email confirmation, plus Google and Apple OAuth; admin approval gates new accounts
• Dark mode — system-aware theme toggle, persisted in localStorage
• Evernote import — import notes from .enex files with full content and attachment support
• MCP server — expose your notes to Claude Desktop, Claude Cowork, and other MCP clients via eu.drafto/mcp on the MCP Registry
• Real-time support pipeline — mail to [email protected] is polled every 5 minutes by a Mac-mini-resident agent, classified by Claude Code, and synced bidirectionally with GitHub issues; see docs/features/support-agent.md

See docs/features/ for one brief per functional area (code paths, ADRs, testing).

Tech Stack

Area	Stack
Web	Next.js 16 (App Router, Turbopack), React 19, TypeScript, Tailwind CSS v4, BlockNote
Mobile	Expo 55, React Native 0.84, expo-router, TenTap editor, WatermelonDB
Desktop	React Native macOS 0.81.5, TenTap editor, WatermelonDB (shared with mobile)
Backend	Supabase (Postgres + Auth + Storage + RLS)
Hosting	Vercel (web), Fastlane → App Store / Play Store / Mac App Store
Monitoring	Sentry (errors), PostHog (analytics)
Testing	Vitest, Testing Library, Playwright, Jest, Maestro
Monorepo	pnpm workspaces + Turborepo

Architecture deep-dive: docs/architecture/overview.md.

Getting Started

Prerequisites

• Node.js 22+
• pnpm
• A Supabase project + Supabase CLI
• Playwright browsers — pnpm exec playwright install (for E2E)

For mobile dev: Expo CLI, Android SDK, Xcode. For desktop dev: Xcode, CocoaPods (gem install cocoapods), Ruby 3.3.7 via rbenv.

Full first-time setup guide: docs/operations/local-dev-setup.md.

Setup

git clone https://github.com/JakubAnderwald/drafto.git
cd drafto
pnpm install

# Configure web env
cp apps/web/.env.local.example apps/web/.env.local
# Fill in NEXT_PUBLIC_SUPABASE_URL and NEXT_PUBLIC_SUPABASE_ANON_KEY

# Push schema to your Supabase project
supabase link --project-ref <your-project-ref>
supabase db push

# Run the dev server
pnpm dev

Open http://localhost:3000.

Scripts

Dev commands live here. Build / release / deployment commands live in docs/operations/builds-and-releases.md.

Command	Description
pnpm dev	Start dev server (all apps)
pnpm build	Production build
pnpm lint	ESLint (all packages)
pnpm format:check	Prettier check
pnpm test	Unit + integration tests
pnpm typecheck	TypeScript check
pnpm migration:check	Check migrations for destructive SQL and missing Data API grants

Per-app test commands: docs/architecture/testing.md.

Project Layout

apps/
  web/       Next.js web app (App Router)
  mobile/    Expo + React Native iOS/Android
  desktop/   React Native macOS
packages/
  shared/    TypeScript types + constants (@drafto/shared)
supabase/
  migrations/
docs/
  features/       Per-area briefs (auth, notes, editor, sync, search, MCP, …)
  architecture/   System shape (overview, environments, testing)
  operations/     Runbooks (local-dev-setup, builds-and-releases, migrations)
  adr/            Architecture Decision Records
  archive/        Historical plans (not source of truth)

Full index: docs/README.md.

Contributing

All work goes through branches + PRs — see CLAUDE.md for the project conventions (worktree workflow, SOLID, testing requirements, production safety rails). Decisions are recorded in docs/adr/.

License

Private project.