Development

Development

Prerequisites

• Python 3.11+
• uv
• Node.js 24+
• pnpm
• Docker and Docker Compose for full-stack local runs

Backend

cd backend
uv sync --extra dev

VAULT_DB_URL=sqlite:///./dev.sqlite \
VAULT_DATA_DIR=./_data/files \
VAULT_THUMB_DIR=./_data/thumbs \
uv run uvicorn app.main:app --reload

Frontend

cd frontend
pnpm install
pnpm dev

Backend Checks

cd backend
uv run pytest tests -v
uv run ruff check app/ tests/
uv run ruff format app/ tests/

Frontend Checks

cd frontend
pnpm typecheck
pnpm lint
pnpm build
pnpm test:e2e

Docker

docker compose up -d --build