Prerequisites
Docker-based Development (Recommended)
For the simplest setup, you only need:
- Docker & Docker Compose
- just task runner
- (For mobile testing) Expo Go app on your device or an Android/iOS simulator
This is the recommended approach. All backend dependencies, database, and tooling run inside containers.
Native Development
If you prefer running services directly on your machine:
- Node.js 20+
- pnpm (package manager)
- Python 3.12+
- uv (Python package manager)
- PostgreSQL 16 (or use SQLite for local dev)
Optional
- just -- Unified task runner with recipes for all common workflows
- An OpenAI API key -- Required for receipt parsing and AI agent features