The fastest way to start building with KoppaJS.
Table of Contents
create-koppajs is the official project scaffolder for KoppaJS.
It creates a ready-to-run starter project with a single command — no configuration, no dependencies to install first, no boilerplate to write by hand.
pnpm create koppajs my-appnpm create koppajs my-appnpx create-koppajs my-appThen:
cd my-app
pnpm install
pnpm devIf you omit the project name, the CLI will prompt you for one.
my-app/
├── .github/
├── .husky/
├── docs/
├── tests/
├── CHANGELOG.md
├── RELEASE.md
├── AI_CONSTITUTION.md
├── ARCHITECTURE.md
├── package.json
├── .gitignore
├── README.md
├── vite.config.mjs
├── vitest.config.mjs
├── playwright.config.ts
├── tsconfig.json
├── pnpm-lock.yaml
├── LICENSE
├── public/
│ └── favicon.svg
└── src/
├── main.ts
├── style.css
├── app-view.kpa
└── counter-component.kpa
- Vite as dev server and bundler
- TypeScript, ESLint, Prettier, Vitest, and Playwright
- GitHub workflows, Husky, lint-staged, and Conventional Commits
- Meta-layer docs, ADRs, specs, and a release baseline
- Two sample components (app view + counter) aligned with the current
koppajs-examplestarter
create-koppajs: Node.js >= 20- Generated starter workflow: pnpm >= 10 plus a starter-supported Node.js line (currently 20.19+, 22.13+, or 24+)
The scaffolded starter now ships with the same quality and governance baseline
as the current official koppajs-example, adapted for generated projects:
- explicit meta docs and ADR/spec structure
- tag-driven
CHANGELOG.mdplusRELEASE.md - Conventional Commit enforcement via
commitlint - a generated-project CI/release baseline under
.github/workflows
Issues and pull requests are welcome:
https://github.com/koppajs/create-koppajs/issues
Repository design and maintenance rules live in the meta layer:
- AI_CONSTITUTION.md
- ARCHITECTURE.md
- DEVELOPMENT_RULES.md
- TESTING_STRATEGY.md
- RELEASE.md
- docs/meta/README.md
Apache-2.0 — © 2026 KoppaJS, Bastian Bensch