Quick Start

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:

Checks prerequisites (Python, Node, Git)
Creates a Python virtual environment in ~/.draft/venv/
Installs backend and frontend dependencies
Runs database migrations
Starts both servers
Opens your browser automatically

What You’ll See

Once running, Draft serves:

Service	URL
Frontend (Kanban Board)	http://localhost:5173
Backend API	http://localhost:8000
API Documentation	http://localhost:8000/docs

Press Ctrl+C to stop all services gracefully.

CLI Options

npx draft-board --help

Flag	Description	Default
`-p, --port`	Backend server port	`8000`
`--frontend-port`	Frontend dev port	`5173`
`--skip-setup`	Skip dependency installation	`false`
`--dev`	Force development mode (hot reload)	`false`
`-v, --version`	Show 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"}

Getting Started

Core Concepts

AI Executors

Guides

Prerequisites

One Command

What You’ll See

CLI Options

Development Setup

Verify Installation

Next Steps

Configuration

Your First Ticket

​Prerequisites

​One Command

​What You’ll See

​CLI Options

​Development Setup

​Verify Installation

​Next Steps

Configuration

Your First Ticket

Prerequisites

One Command

What You’ll See

CLI Options

Development Setup

Verify Installation

Next Steps