@kompojs/blueprints

Blueprint packages for the Kompo framework.

Starters, adapters, design systems, and framework templates.

---

What is this repo?

This monorepo contains all the blueprint packages for Kompo. Blueprints define the templates, starters, adapters, and design system integrations that the Kompo CLI uses to scaffold and generate code.

Packages

Package	Description
@kompojs/blueprints	Core blueprints (adapters, drivers, features, starters for all frameworks)
@kompojs/blueprints-nextjs	Next.js-specific elements and starters
@kompojs/blueprints-react	React-specific elements and starters
@kompojs/blueprints-nuxt	Nuxt-specific elements and starters
@kompojs/blueprints-vue	Vue-specific elements and starters
@kompojs/blueprints-express	Express-specific elements and starters

How Blueprints Work

When you run kompo add app, the CLI resolves blueprints using a registry with this resolution order:

1. Local (.kompo/templates/) — your project overrides
2. Installed packages (@kompojs/blueprints-nextjs, etc.) — framework-specific
3. Core (@kompojs/blueprints) — built-in fallback

Blueprint Package Manifest

Each blueprint package declares its capabilities via a kompo.blueprint.json:

{
  "$schema": "https://kompojs.dev/schemas/kompo.blueprint.json",
  "kompo": "1.0",
  "name": "@kompojs/blueprints-nextjs",
  "type": "framework",
  "framework": "nextjs",
  "paths": {
    "elements": "elements/",
    "starters": "starters/"
  }
}

Creating a Custom Blueprint Package

You can create your own blueprint package for community or internal use:

1. Create the package

mkdir my-kompo-blueprints && cd my-kompo-blueprints
npm init -y

2. Add the manifest

Create kompo.blueprint.json:

{
  "$schema": "https://kompojs.dev/schemas/kompo.blueprint.json",
  "kompo": "1.0",
  "name": "@acme/kompo-blueprints-sveltekit",
  "type": "framework",
  "framework": "sveltekit",
  "paths": {
    "elements": "elements/",
    "starters": "starters/"
  }
}

3. Add elements and starters

my-kompo-blueprints/
  kompo.blueprint.json
  elements/
    apps/sveltekit/
      framework/
        files/          # Template files (.eta)
        catalog.json    # Dependencies
  starters/
    sveltekit/
      tailwind/
        blank/
          starter.json

4. Publish

npm publish

Users install it with:

pnpm add -D @acme/kompo-blueprints-sveltekit

The Kompo CLI will automatically discover it.

Development

git clone https://github.com/kompojs/blueprints.git
cd blueprints
pnpm install
pnpm build

Related Repositories

Repository	Description
kompojs/kompo	CLI, kit, config, core runtime
kompojs/create-kompo	create-kompo scaffolder
kompojs/workbench	Visual architecture explorer

Contributing

We welcome blueprint contributions! Whether it's a new framework, design system, or adapter:

1. Fork this repo
2. Create your blueprint package under packages/
3. Add a kompo.blueprint.json manifest
4. Add your templates in elements/ and starters in starters/
5. Submit a pull request

See the Contributing Guide for details.

License

MIT © 2026 SmarttDev and Kompo contributors