Skip to content

Development Setup

Set up Maxwell's Wallet for local development.

Prerequisites

  • Python 3.11+
  • Node.js 22+ (LTS) - pinned via .nvmrc
  • uv - Fast Python package manager

Tip: If you use nvm, run nvm install in the repo root to install the correct Node version.

# Install dependencies and seed database
make setup

# Start both servers
make dev

Manual Setup

Backend

cd backend

# Create virtual environment
uv venv
source .venv/bin/activate

# Install dependencies
uv pip install -e .

# Seed database
uv run python -m app.seed

# Start server
uv run uvicorn app.main:app --reload --port 8000

Frontend

cd frontend

# Install dependencies
npm install

# Start dev server
npm run dev

Useful Commands

make help           # Show all commands
make test-backend   # Run backend tests
make db-reset       # Reset database
make db-seed        # Seed sample data
make status         # Check if servers running

Database Migrations

cd backend
uv run alembic revision --autogenerate -m "description"
uv run alembic upgrade head