create-aksell

Scaffold a new Aksell UI project from the command line.

create-aksell creates a ready-to-edit project using the Aksell design system. It supports a zero-build HTML template and an Astro template wired up with @aksell/ui.

Quick Start

npx create-aksell

The CLI will ask for:

• A project name
• A template: html or astro

Then it creates a new folder with the selected template.

Non-Interactive Usage

Use flags when scripting, documenting setup steps, or asking an AI coding tool to scaffold a project.

npx create-aksell --name price-calculator --template html

npx create-aksell --name landing-page --template astro

Available flags:

| Flag | Description | | --- | --- | | --name | Name of the folder/project to create | | --template | Template to use: html or astro |

Templates

html

A zero-build starter that loads Aksell UI styles from a CDN.

npx create-aksell --name my-tool --template html
cd my-tool
open index.html

Best for small tools, prototypes, static pages, and examples that should run without a build step.

astro

An Astro starter preconfigured with @aksell/ui.

npx create-aksell --name my-site --template astro
cd my-site
npm install
npm run dev

Best for full sites, routed experiences, and projects that need a modern build setup.

Both templates include an npm run check command with lightweight Aksell guardrails.

Coding With AI

The scaffolded projects include CLAUDE.md and AGENTS.md files that explain the Aksell design system to AI coding tools.

You can install the Claude plugin:

claude plugin marketplace add aksellsor/claude-plugins
claude plugin install aksell-project

Or paste a prompt like this into Claude Code, Codex, or another AI editor from an empty folder:

Scaffold a price calculator project using:
  npx create-aksell --name price-calculator --template html

Then build a simple price calculator page with:
- A product name input
- A quantity input
- A unit price input
- A calculated total that updates live
- A "Copy quote" button that shows a toast confirmation

Use only aksell-ui components and styles. No frameworks, no Tailwind.

Replace price-calculator and the feature list with your own project idea.

Aksell UI

This package scaffolds projects that use the @aksell/ui npm package.

• npm: @aksell/ui
• Demo: aksell-ui.aksell.workers.dev

License

MIT