Potion Notes MVP

Monorepo MVP for:

• Web backend: FastAPI + SQLite
• Web frontend: Svelte + Vite
• Android app: Kotlin + Room (offline-first)

Quick start (web MVP)

./run_mvp.sh

Then open the URL shown by Vite (usually http://localhost:5183).

Manual run

1) Backend

cd backend
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
uvicorn app.main:app --reload --host 0.0.0.0 --port 8100

2) Frontend

cd frontend
npm install
VITE_API_BASE=http://localhost:8100 npm run dev -- --host 0.0.0.0 --port 5183

VITE_API_BASE is optional.

• unset: uses same-origin API paths (for future backend / hosting)
• set: uses explicit backend origin in local split-port dev

What you can verify in MVP now

• Create a note
• Edit and save markdown with revision conflict checks
• View revision history
• Upload and open attached assets
• Run a mock agent task and see output

Android app

Open android/ in Android Studio and run the app. Current Android app is fully offline local note management using Room.