What is this?

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.

Usage

pnpm create koppajs my-app

npm create koppajs my-app

npx create-koppajs my-app

Then:

cd my-app
pnpm install
pnpm dev

If you omit the project name, the CLI will prompt you for one.

What gets generated

my-app/
├── index.html
├── package.json
├── tsconfig.json
├── vite.config.mjs
├── .gitignore
├── LICENSE
├── README.md
├── public/
│   └── favicon.svg
└── src/
    ├── main.ts
    ├── style.css
    ├── app-view.kpa
    └── counter-component.kpa

• Vite as dev server and bundler
• TypeScript support out of the box
• Two sample components (app view + counter) to get started
• Zero unnecessary dependencies

Requirements

• Node.js >= 20

Community & Contribution

Issues and pull requests are welcome:

https://github.com/koppajs/create-koppajs/issues

License

Apache-2.0 — © 2026 KoppaJS, Bastian Bensch