Contributing to Connectum

Thank you for your interest in contributing to Connectum! This guide will help you get started.

Where to Start

1. Development Setup -- clone repos, install dependencies, run tests
2. CLI Commands -- all commands for working with the monorepo
3. About Connectum -- understand the package layers and design

Repository Structure

Connectum is organized as 3 independent repositories under the Connectum-Framework GitHub organization:

Repository	Description
connectum	Framework code -- pnpm workspace monorepo
docs	Documentation site (VitePress)
examples	Usage examples

Guidelines

Code Style

• Biome for linting and formatting (pnpm lint / pnpm format)
• Native TypeScript -- no enum, explicit import type, .ts extensions
• Named parameters -- prefer options objects over positional arguments
• Node.js 25+ required for development (consumers: Node.js 18+)

Commits

• Use Conventional Commits format
• One logical change per commit
• Run pnpm typecheck && pnpm test before committing

Architecture Decision Records

Significant design decisions are documented as ADRs in the ADR index. When proposing a change that affects the architecture, create a new ADR.

Quick Commands

cd connectum

pnpm install          # Install dependencies
pnpm typecheck        # Type check all packages
pnpm test             # Run all tests
pnpm lint             # Check code style
pnpm format           # Auto-fix formatting
pnpm changeset        # Create a changeset for versioning