Deployment

Each component is deployed independently. You can also run everything locally with Docker Compose.

Overview

Component	Platform	Configuration
Dashboard App	Railway	Nixpacks (PHP 8.3)
Brand Site	Vercel	Auto-detect (Next.js)
Docs	Cloudflare Pages	Auto-detect (Astro)
Agents Service	Railway	Docker
Postgres	Railway	Managed add-on

Docker Compose (recommended for local dev)

The project includes a docker-compose.yml that starts all services:

./start.sh

This starts:

laravel-app — Dashboard + API on port 8080, Reverb WebSocket on port 8082
brand-site — Marketing site on port 3000
docs-site — Documentation on port 3002
agents-service — Code improvement API on port 8081

All services share an agent-os-network Docker bridge. The Laravel app uses SQLite in a Docker volume.

Environment variables

Copy .env.example to .env and set:

GROQ_API_KEY=...          # For agents service
APP_KEY=...               # Laravel app key
BROADCAST_CONNECTION=reverb
REVERB_APP_ID=...
REVERB_APP_KEY=...
REVERB_APP_SECRET=...

Dashboard App on Railway

Build via Nixpacks

Railway detects the Laravel app automatically via Nixpacks (PHP 8.3). composer.json defines a setup script (key:generate + migrate + cache) and the start command.

Start command

php artisan migrate --force && php artisan config:cache && php artisan serve --host=0.0.0.0 --port=8080

Environment variables

Set these in the Railway dashboard:

APP_KEY — Laravel app key (php artisan key:generate --show)
DB_CONNECTION=pgsql + Railway Postgres connection variables
APP_URL — public URL of the deployed app
BROADCAST_CONNECTION=reverb — for real-time WebSocket updates
REVERB_APP_ID, REVERB_APP_KEY, REVERB_APP_SECRET — Reverb credentials

Brand Site on Vercel

Vercel detects Next.js automatically. Connect the repository and set the root directory to apps/brand-site/. No further setup required — Vercel Analytics and SpeedInsights are already integrated.

Docs on Cloudflare Pages

Cloudflare Pages detects Astro automatically. Connect the repository, set root directory to apps/docs/, build command npm run build, output directory dist.

Local development (without Docker)

# 1. Laravel App (Port 8000)
cd apps/app
composer install && npm install
cp .env.example .env
php artisan key:generate && php artisan migrate
php artisan serve
npm run dev  # Vite assets in a separate terminal

# 2. Reverb WebSocket server
cd apps/app
php artisan reverb:start

# 3. Brand Site (Port 3000)
cd apps/brand-site
npm install && npm run dev

# 4. Docs (Port 4321)
cd apps/docs
npm install && npm run dev

Required environment variables in apps/app/.env:

DB_CONNECTION=sqlite
BROADCAST_CONNECTION=reverb
REVERB_APP_ID=my-app
REVERB_APP_KEY=my-key
REVERB_APP_SECRET=my-secret
REVERB_HOST=localhost
REVERB_PORT=8082