Environments
CXGear is not a single website process. Several services work together. Knowing which one does what helps when something “does nothing.”
Services
Section titled “Services”| Service | Role |
|---|---|
| Web | The UI you use in the browser |
| API | Login, projects, billing, channels, job creation |
| Runtime | Actually runs spinner jobs (steps, AI, channels) |
| Database | Stores orgs, tables, jobs, sessions |
If the web and API are up but the runtime is not, you can create projects and click Run now, but jobs will not progress.
Local development
Section titled “Local development”Typical local URLs:
| Piece | URL |
|---|---|
| Web | http://localhost:5173 |
| API | http://localhost:3000 |
| Docs | http://localhost:4321 |
| Runtime | http://localhost:3001 (health only; workers poll the DB) |
Important environment variables:
| Variable | Purpose |
|---|---|
PUBLIC_API_URL | Public base URL of the API (OAuth redirects, webhooks) |
PUBLIC_APP_URL | Public base URL of the web app |
META_APP_ID / META_APP_SECRET | WhatsApp Meta OAuth |
DATABASE_URL | Postgres connection |
For Meta OAuth in production, PUBLIC_API_URL must be your real HTTPS API host (for example https://api.cxgear.ai), and that host must match the redirect URI in the Meta app.
Production sketch
Section titled “Production sketch”- app.cxgear.ai — web UI
- api.cxgear.ai — API
- docs.cxgear.ai — this documentation site
- Runtime workers — one or more processes with DB access