# rundraft — complete reference

rundraft gives every GitHub pull request a live preview environment.

## Zero-config detection (priority order)

1. rundraft.yml — full control
2. Dockerfile — build, expose detected port
3. docker-compose.yml — every service with build:, one ingress
4. package.json + framework — static build served via nginx with SPA routing

## rundraft.yml schema

Single-service:
version: "1"
port: 3000
dockerfile: Dockerfile
build: .

Multi-service:
version: "1"
services:
  web:
    port: 3000
    build: .
    ingress: true
  api:
    port: 8080
    build: ./api

Optional, top level: walkthrough: true — run an AI walkthrough on every push.

## AI walkthroughs (pay-as-you-go)

Claude reads the PR diff, clicks through the preview in a real browser, and comments on the PR with a pass/fail check per feature, screenshots and a recording. Trigger with a "/rundraft walkthrough" PR comment (owners, members, collaborators) or "walkthrough: true" in rundraft.yml. Billed per minute of runtime; capped at 5 minutes per run.

## Preview URL scheme

https://pr-{pr_number}.preview.rundraft.sh

## Pricing

- Free: 1 repo, 3 concurrent previews, 0.5 CPU / 512 MB per preview, sleeps after 30 min without requests
- Pay-as-you-go: €10/month + €0.05/preview-hour, unlimited repos, 2 CPU / 2 GB per preview (standard); large 4 CPU / 4 GB bills 2×, XL 8 CPU / 8 GB bills 4×; sleeps when idle (15 min – 4 h or never, per repo), hours asleep aren't billed

## Operator

rundraft is operated by Gotfred ApS, Denmark.
Contact: privacy@rundraft.sh