create-zoijs

Create a new Zoijs app with one command. Plain HTML, CSS, and JavaScript — no build step.

Usage

npm create zoijs@latest my-app
cd my-app
npm install
npm run dev

npm run dev starts a tiny zero-dependency static server (no serve, no bundler, no build step):

  Zoijs dev server

  - Local:  http://localhost:7310

(It falls back to 7311–7313 if the port is busy.)

Or with npx:

npx create-zoijs my-app

A note on the name. npm maps npm create zoijs to the package create-zoijs (that's npm's convention for npm create <name>), which is why this package is create-zoijs rather than @zoijs/create.

Naming your app

The folder name you pass becomes the project name:

npm create zoijs@latest task-manager

produces a package.json with "name": "task-manager" and an index.html with <title>Task Manager</title>. If you don't pass a name, the CLI asks for one.

Templates

npm create zoijs@latest my-app                       # default: the "app" template
npm create zoijs@latest my-app --template app        # a polished project dashboard
npm create zoijs@latest my-app --template basic      # a basic counter
npm create zoijs@latest my-app --template typescript # type-checked JS, no build step
npm create zoijs@latest my-app --template minimal    # two flat files, CDN, no install
npm create zoijs@latest my-app --template library    # author a Zoijs-based package

• app (default) — a polished project dashboard (hero, stat cards, filters, empty state) showing html, mount, createState, computed, each, conditional rendering, and parent⇄child component communication.
• basic — a basic counter, a small local app with a dev server.
• typescript — the counter as type-checked JavaScript (// @ts-check + strict tsconfig.json + npm run typecheck). Full TS safety, no build step.
• minimal — the smallest scaffold: two flat files loading @zoijs/core from a CDN. No install, no dev server — run with npx serve . -l 7310.
• library — a starter for authoring a Zoijs-based package: src + .d.ts, exports/types, a peer dep on @zoijs/core, and a node:test suite.

What it does

• Copies a template, fills in the app name, and prints the next three commands.
• Validates the name (npm-safe) and won't overwrite a non-empty folder.

What it does not do

By design, to keep Zoijs simple: no build system, no bundler, no compiler, no JSX transform, no code generation, no plugin system, no template DSL, and no complex prompts. The generated app is plain files you can read.

You don't need this tool

Zoijs works without the CLI — it's only a convenience. You can create an app by hand with an import map and a <script type="module">, or with npm install @zoijs/core. See the Start guide.

License

MIT © Zoijs contributors