@herdingbits/create-trailhead

Scaffold a new Trailhead application shell with a single command.

Usage

npx @herdingbits/create-trailhead my-app

Options

npx @herdingbits/create-trailhead <project-name> [options]

Options:
  --design-system <name>   Design system to use (shoelace|cloudscape)
  --no-demo               Skip creating demo app
  --help, -h              Show help message

Examples

Create with Shoelace (default)

npx @herdingbits/create-trailhead my-app

Create with CloudScape

npx @herdingbits/create-trailhead my-app --design-system cloudscape

Create without demo app

npx @herdingbits/create-trailhead my-app --no-demo

What Gets Created

my-app/
├── shell/                  # Application shell
│   ├── src/
│   ├── public/
│   │   └── navigation.json
│   ├── index.html
│   ├── vite.config.js
│   └── package.json
├── apps/
│   └── demo/              # Demo SPA (if --no-demo not specified)
│       ├── src/
│       ├── index.html
│       ├── vite.config.js
│       └── package.json
├── deploy.js              # Deployment assembly script
├── package.json
└── README.md

Next Steps

After creating your project:

# Install and start shell
cd my-app/shell
npm install
npm start  # Port 3001

# In another terminal, install and start demo app
cd my-app/apps/demo
npm install
npm start  # Port 3000

# Visit http://localhost:3001

Adding New Apps

Copy the demo app structure:

cd my-app
cp -r apps/demo apps/users

Update shell/public/navigation.json:

{
  "id": "users",
  "path": "/users",
  "app": "users",
  "icon": "people",
  "label": "Users",
  "order": 2
}

Documentation

• Trailhead Documentation
• Getting Started Guide

License

MIT