@kompojs/core

The core monorepo for the Kompo CLI and runtime packages.

---

What is this repo?

This is the core monorepo for Kompo — a code orchestration framework for TypeScript, built on Hexagonal Architecture (Ports & Adapters).

This repo contains the CLI, configuration, and runtime packages. Blueprints, the workbench, and the scaffolder live in their own repositories:

Repository	Description
kompojs/kompo (this repo)	CLI, kit, config, core runtime
kompojs/blueprints	Blueprint packages (starters, adapters, framework templates)
kompojs/create-kompo	create-kompo scaffolder
kompojs/workbench	Visual architecture explorer

---

Packages

Package	npm	Description
@kompojs/cli		Command-line interface
@kompojs/kit		Shared utilities and interfaces
@kompojs/config		Configuration and constants
@kompojs/core		Meta-package (installs CLI + deps)

---

Quick Start

New project

pnpm create kompo@latest my-app

Existing monorepo

# Install
pnpm add -D @kompojs/core

# Initialize
pnpm kompo init

# Add your first app
pnpm kompo add app

Key commands

kompo init                    # Initialize Kompo in an existing monorepo
kompo add app                 # Add a new application
kompo add domain <name>       # Add a business domain
kompo add adapter             # Add an adapter (interactive)
kompo wire <domain>           # Wire a domain to an app
kompo doctor                  # Check project health
kompo list starters           # List available starters
kompo list blueprints         # List installed blueprint packages

---

Development

# Clone
git clone https://github.com/kompojs/kompo.git
cd kompo

# Install
pnpm install

# Build all packages
pnpm build

# Run CLI in dev mode
pnpm --filter @kompojs/cli kompo <command>

# Typecheck
pnpm --filter @kompojs/cli typecheck

# Run tests
pnpm test

---

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

1. Fork the repo
2. Create a feature branch: git checkout -b feature/my-feature
3. Make your changes and add tests
4. Submit a pull request

Community

• Documentation
• Discord
• Twitter/X
• GitHub Discussions

---

License

MIT © 2026 SmarttDev and Kompo contributors