Create a Start UI project

CLI tool to scaffold new Start UI projects:

• Start UI web
• Start UI native

Usage

pnpm create start-ui myApp              # Prompts for project type (web/native)
pnpm create start-ui -t web myApp       # Create a start-ui-web project
pnpm create start-ui -t native myApp    # Create a start-ui-native project

Options

Usage: create-start-ui [options] <appName>

Arguments:
  appName                Name of the app to create

Options:
  -b, --branch <branch>  Specify a branch you want to use to start
  -t, --type <type>      Type of app you want to create (web or native)
  --skip-install         Skip node modules installation step (default: false)
  --skip-git-init        Skip git init step (default: false)
  --verbose              Add additional details if something goes wrong (default: false)
  -V, --version          output the version number
  -h, --help             display help for command

Project Structure

src/
  index.ts              # CLI entry point — parses args, orchestrates scaffolding
  lib/
    cli.ts              # Commander.js program definition
    conf.ts             # Persistent config (telemetry consent)
    debug.ts            # Conditional debug logging (--verbose)
    download.ts         # Download template tarball from GitHub
    env.ts              # Validate environment (check folder doesn't exist)
    extract.ts          # Extract tarball and copy files to project folder
    repos.ts            # GitHub repo URLs and default branches
    sentry.ts           # Error tracking (opt-in telemetry)
    spinner.ts          # CLI spinner instance
  target/
    web/index.ts        # Post-setup script for web projects
    native/index.ts     # Post-setup script for native projects (WIP)

Development

1. Link the CLI globally:

pnpm link-cli

2. Run in watch mode (rebuilds on save):

pnpm dev

3. Test the CLI from any directory:

create-start-ui myApp

Troubleshooting

Folder already exists

The CLI won't overwrite an existing folder. Remove or rename it first.

Cannot download template

Check your internet connection. If using --branch, verify the branch exists on the target GitHub repository (web or native).

pnpm not found

The CLI uses pnpm to install dependencies. Install it with npm install -g pnpm or use --skip-install and install dependencies manually.

Permission errors

Make sure you have write access to the target directory.