⚠️ Kompo is no longer maintained

Kompo has been discontinued and is no longer actively maintained.

The repository is kept available for archival and reference purposes, but no new features, bug fixes, or support should be expected.

Thank you to everyone who contributed, tested, reported issues, or used Kompo.

Status: Archived
Maintenance: Discontinued
Date: October 2026

---

@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