Backend API
Work in apps/backend-api — Go Gin. Default listen port is not finalized yet; see Local services.
Welcome to 
Developer handbook for VEXiL — SideFX Houdini-centric project management. Setup, architecture, and contribution workflow live here.
What is VEXiL?
Section titled “What is VEXiL?”VEXiL is a Houdini-centric project management tool with quality-of-life features for VFX pipelines. The name nods to VEX (Vector Expression Language) in SideFX Houdini.
The product is developed as a Bun + Turborepo monorepo: a Go Gin backend API, Astro frontend apps, a Houdini plugin scaffold, and developer tooling.
Repository at a glance
Section titled “Repository at a glance”| Path | Role |
|---|---|
apps/backend-api |
Go Gin API |
apps/frontend-app |
Product UI (Astro) |
apps/website-vexil |
Marketing site (Astro + Tailwind) |
apps/plugins/houdini-package |
Houdini plugin (Python / uv) |
dev-tools/env-init |
Env / Docker TUI (Textual) |
docs/dev |
These docs (run separately) |
Ignore legacy empty leftovers under older apps/ paths. Details: Repository Structure.
Start here
Section titled “Start here”Getting StartedPrerequisites, Devcontainer or manual setup, and bun run dev.
Repository StructureWhere each app lives and which stack it uses.
ContributingBranch from dev, PR process, Conventional Commits, AI policy.
Local services & portsKnown frontend ports, Docker Compose, API port status.
Pick a surface
Section titled “Pick a surface”Product UI
Work in apps/frontend-app (Astro). Typical local URL: http://localhost:4321.
Marketing site
Work in apps/website-vexil (Astro + Tailwind).
Houdini plugin
Work in apps/plugins/houdini-package. Optional — only if you have SideFX Houdini installed.
Docs
Improve this handbook under docs/dev. Hosted at dev-docs.vexil.tools.