WriteKit - Local Development

Prerequisites

• Docker & Docker Compose
• GitHub OAuth App (for login)

Setup GitHub OAuth

1. Go to https://github.com/settings/developers
2. New OAuth App:
   • Name: WriteKit Local
   • Homepage: http://writekit.lvh.me
   • Callback: http://writekit.lvh.me/auth/github/callback
3. Copy Client ID and Secret

Run

# Set OAuth credentials
export GITHUB_CLIENT_ID=your_client_id
export GITHUB_CLIENT_SECRET=your_client_secret

# Start
docker compose up --build

Or create .env file:

GITHUB_CLIENT_ID=your_client_id
GITHUB_CLIENT_SECRET=your_client_secret

Access

• Platform: http://writekit.lvh.me
• Traefik dashboard: http://localhost:8080
• MinIO console: http://localhost:9001 (minioadmin/minioadmin)

Create a demo

curl -X POST http://writekit.lvh.me/api/demo

Returns subdomain like demo-abc123.writekit.lvh.me - works automatically, no hosts file needed.

Environment Variables

Required

Variable	Description
DATABASE_URL	PostgreSQL connection string
DOMAIN	Base domain
BASE_URL	Full URL for OAuth callbacks
SESSION_SECRET	Cookie encryption (32+ chars)
GITHUB_CLIENT_ID	GitHub OAuth client ID
GITHUB_CLIENT_SECRET	GitHub OAuth secret

Optional

Variable	Description
GOOGLE_CLIENT_ID/SECRET	Google OAuth
DISCORD_CLIENT_ID/SECRET	Discord OAuth
R2_*	Cloudflare R2 storage
IMAGINARY_URL	Image processing service
CLOUDFLARE_API_TOKEN/ZONE_ID	Analytics