> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ooneex.com/llms.txt
> Use this file to discover all available pages before exploring further.

# spa:create

> Generate a new spa module.

Scaffold a standalone Vite single-page application module. The command pulls the spa source from the upstream skeleton repository, marks the module as a `spa` in its yml config, assigns a free dev port, and installs the spa dependencies. You can link the spa to an existing design module or scaffold a new one.

## Usage

```bash theme={null}
ooneex spa:create [options]
```

## Examples

```bash theme={null}
# Interactive: prompts for the spa name and design module
ooneex spa:create

# Provide the name as a flag
ooneex spa:create --name=dashboard

# Link the spa to a design module
ooneex spa:create --name=dashboard --design=ui
```

## Options

| Option     | Description                                                                                                         | Default                   |
| ---------- | ------------------------------------------------------------------------------------------------------------------- | ------------------------- |
| `--name`   | Spa name. Normalized to PascalCase with any trailing `Module` stripped; the module folder uses its kebab-case form. | Prompted if omitted       |
| `--design` | Design module the spa uses. An existing design can be chosen interactively, or a new name is scaffolded.            | Prompted if omitted       |
| `--cwd`    | Project directory the spa is created in.                                                                            | Current working directory |
| `--silent` | Suppress prompts, spinners, and output.                                                                             | `false`                   |