Backend API
Work in apps/vexil-server — 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/vexil-server |
Go Gin API |
apps/vexil-frontend |
Product UI (Astro) |
apps/vexil-website |
Website for VEXiL (Astro + Tailwind) |
apps/vexil-package-src |
Houdini plugin (Python / uv) |
apps/vexil-dev-tools/env-init |
Env / Docker TUI (Textual) |
apps/docs-dev |
These docs (Starlight; port 4323) |
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/vexil-frontend (Astro). Typical local URL: http://localhost:4321.
Website for VEXiL
Work in apps/vexil-website (Astro + Tailwind).
Houdini plugin
Work in apps/vexil-package-src. Requires SideFX Houdini 22.
Docs
Improve this handbook under apps/docs-dev. Hosted at dev-docs.vexil.tools. Local: http://localhost:4323.