Development
Repository development workflows and implementation notes.
The OrcAI repository is a Bun workspace with applications under apps/* and shared packages under packages/*.
Main Applications
apps/app: main OrcAI application.apps/workers: background worker process.apps/web: website and documentation service.
Recommended Workflow
The repository includes a VS Code devcontainer. It starts supporting infrastructure, installs workspace dependencies, applies migrations, initializes MinIO buckets, applies the SpiceDB schema, and runs a workspace container. Application services are started manually with bun run dev:all, or individually with the commands on the Commands page.
For a host or local Docker workflow, use the commands in Commands and the self-hosting pages.
Developer Pages
Commands
Common Bun workspace commands for apps, workers, checks, database migrations, and docs.
Architecture
How app, workers, storage, authorization, retrieval, and AI services fit together.
Contributing
Branching, commit format, local validation, pull request expectations, and docs conventions.
TODO
Document how generated route trees, MDX collections, and testing conventions should be updated once those workflows are stable.