Factory project
An owner-scoped workspace containing a product name, brief, status, and run history.
Early-access documentation
The factory, as it exists today.
This documentation covers the live control plane. Build execution, verification, and previews are documented only after those systems reach production.
Current flow
- 1. Sign in with GitHub
- 2. Create a project
- 3. Save the brief
- 4. Queue a run record
A queued run currently waits for the isolated OpenCode runner gateway. No source repository is modified at this stage.
Core concepts
Brief
The durable statement of the user, problem, constraints, and smallest outcome worth building.
Run
A traceable attempt to move the project through brief, plan, build, verify, preview, and ship phases.
Event
A timestamped status, log, artifact, or preview update associated with one run.
Production architecture
Interface
Next.js + Tailwind
The founder-facing control plane, deployed on Cloudflare.
Identity
GitHub + Better Auth
Authentication and owner identity for factory workspaces.
State
Convex
Realtime projects, runs, and run-event persistence.
Execution
Not live yet
An isolated AWS/OpenCode runner gateway is under development.