Contribute to Caracal

Caracal uses a multi-language workspace: TypeScript apps/packages, Go services/packages, Python packages/examples, Docker/Helm infra, and Astro docs.

Contributor Path

Need	Page
Prepare your machine	Set Up Locally
Learn project boundaries and naming conventions	Follow Project Standards
Work on an issue or pull request	Make a Change
Run the right checks	Validate Changes

Maintainer Path

Need	Page
Understand review, ownership, and security process	Understand Governance
Prepare, publish, or recover a release	Release Caracal

Current Toolchain

Tool	Version
Node.js	24+
pnpm	11.1.1
Docker + Compose v2	24+
Go	1.26+
Python	3.14+
Bun	latest stable used by package scripts

Before You Start

Read Follow Project Standards before editing code, docs, commands, or product boundaries.

Next Step

Start with Set Up Locally before making source changes.