Skip to main content

​
Prerequisites

  • Python 3.11+
  • Node.js 18+
  • Git
No external services (Redis, Postgres, Docker) required — everything runs in-process.

​
One Command

npx draft-board
This single command:
  1. Checks prerequisites (Python, Node, Git)
  2. Creates a Python virtual environment in ~/.draft/venv/
  3. Installs backend and frontend dependencies
  4. Runs database migrations
  5. Starts both servers
  6. Opens your browser automatically

​
What You’ll See

Once running, Draft serves:
ServiceURL
Frontend (Kanban Board)http://localhost:5173
Backend APIhttp://localhost:8000
API Documentationhttp://localhost:8000/docs
Press Ctrl+C to stop all services gracefully.

​
CLI Options

npx draft-board --help
FlagDescriptionDefault
-p, --portBackend server port8000
--frontend-portFrontend dev port5173
--skip-setupSkip dependency installationfalse
--devForce development mode (hot reload)false
-v, --versionShow version—

​
Development Setup

If you’re contributing to Draft or prefer manual control: 
git clone https://github.com/doramirdor/draft.git
cd draft
make setup        # Install all dependencies
make db-migrate   # Run database migrations
make run          # Start backend + frontend
Or run services in separate terminals: 
# Terminal 1
make dev-backend   # FastAPI at http://localhost:8000

# Terminal 2
make dev-frontend  # Vite at http://localhost:5173

​
Verify Installation

curl http://localhost:8000/health
# {"status":"ok"}

curl http://localhost:8000/version
# {"app":"Draft","version":"0.1.0"}

​
Next Steps

Configuration

Set up your AI executor, verification commands, and planner settings.

Your First Ticket

Walk through creating a goal and watching AI implement it.