@aero-js/create

Scaffold a new Aero project. Aero is an HTML-first static site generator powered by Vite.

Usage

pnpm create @aero-js my-app
cd my-app
pnpm dev

Also works with npm, yarn, and pnpm dlx:

npx @aero-js/create@latest my-app
yarn create @aero-js my-app
pnpm dlx @aero-js/create@latest my-app

Options

| Argument | Description | Default | | -------- | -------------------------- | ------------ | | <dir> | Project name and directory | (required) |

What it does

1. Copies the minimal template into a new directory
2. Rewrites package.json with your project name
3. Auto-detects your package manager (pnpm > yarn > npm) and installs dependencies
4. Prints next steps

After scaffolding, the project has @aero-js/core and @aero-js/vite as its framework dependencies.

Project structure

my-app/
├── client/
│   ├── assets/         # Styles, scripts, images
│   ├── components/     # Reusable .html components
│   ├── layouts/        # Layout wrappers with <slot>
│   └── pages/          # File-based routing
├── content/
│   └── site.ts         # Global site data
├── public/             # Static assets (copied as-is)
├── vite.config.ts      # Aero Vite plugin
└── tsconfig.json       # Path aliases

If you change dirs.client (or other dirs) in vite.config.ts or aero.config.ts, update your tsconfig.json paths so they match (e.g. @pages → "<client>/pages"). The dev server will warn when custom dirs are used and a tsconfig is present.

Links

• GitHub
• @aero-js/core on npm

License

MIT