Create Modus App

Interactive CLI to scaffold Modus 2.0 web component applications for React, Angular, and SolidJS.

Templates are bundled directly - no external downloads, works fully offline.

Get Started Now:

npx @julianoczkowski/create-trimble-app@latest

If you run into permission issues, try: sudo npx @julianoczkowski/create-trimble-app@latest

Features

• 📦 Bundled Templates - Templates included in package, no network required
• 🔒 Secure - No runtime external dependencies
• ⚛️ React - React 19 + Vite + Modus 2.0 Components + Cursor Rules
• 🅰️ Angular - Angular 20 + Modus 2.0 Web Components + Cursor Rules
• ▲ SolidJS - SolidJS + Vite + Modus 2.0 Components + Cursor Rules
• 🎯 Interactive - Premium CLI experience with Trimble branding
• ⚡ Fast - Local file copy, instant setup
• ✅ Validated - Post-scaffold lint:all verifies template integrity automatically
• 🔍 Prerequisites Check - Detects Git, Node.js, npm with platform-specific install guides
• 🔄 Update Notifications - Automatic check for newer CLI versions

Usage

Interactive Mode (Recommended)

npx @julianoczkowski/create-trimble-app@latest

This will guide you through:

1. Environment check (Git, Node.js, npm)
2. GitHub account setup (with guided signup if needed)
3. Framework selection (React, Angular, or SolidJS)
4. Installation location choice
5. Project name input
6. Optional dependency installation

Command Line Options

# Create with project name
npx @julianoczkowski/create-trimble-app@latest my-app

# Specify framework
npx @julianoczkowski/create-trimble-app@latest my-app --framework react

# Install in current folder
npx @julianoczkowski/create-trimble-app@latest --current-folder

# Preview without creating files
npx @julianoczkowski/create-trimble-app@latest my-app --dry-run

# Enable verbose output
npx @julianoczkowski/create-trimble-app@latest my-app --verbose

# Show CLI information
npx @julianoczkowski/create-trimble-app@latest --info

# Skip dependency installation
npx @julianoczkowski/create-trimble-app@latest my-app --no-install

# Skip prerequisite environment checks
npx @julianoczkowski/create-trimble-app@latest my-app --skip-checks

# Show help
npx @julianoczkowski/create-trimble-app@latest --help

CLI Options

| Option | Description | | ------------------------ | -------------------------------------- | | [project-name] | Name of the project to create | | -f, --framework <name> | Framework to use (react, angular, solidjs) | | --current-folder | Install in current folder | | --dry-run | Preview what would be created | | --verbose | Enable verbose output for debugging | | --info | Show information about this CLI | | --no-install | Skip automatic dependency installation | | --skip-checks | Skip prerequisite environment checks | | -v, --version | Display version number | | -h, --help | Display help |

Supported Frameworks

| Framework | Description | What's Included | | --------------- | --------------- | -------------------------------------------------------------------------------------------------------- | | ⚛️ React | React 19 + Vite | 47 Modus components, 46 demos, 43 Cursor Rules, 8 lint scripts, Tailwind CSS 3, TypeScript, Husky hooks | | 🅰️ Angular | Angular 20 | 48 Modus components, 45 demos, 50 Cursor Rules, 7 lint scripts, Tailwind CSS 4, TypeScript, Husky hooks | | ▲ SolidJS | SolidJS + Vite | 47 Modus components, 46 demos, 45 Cursor Rules, 8 lint scripts, Tailwind CSS 3, MCP Servers, Vitest |

What's Included in Each Template

All templates come fully configured with:

your-project/
├── .cursor/           # Cursor IDE rules for Modus development
│   ├── rules/         # 40+ AI development rules
│   └── commands/      # AI-powered scaffolding commands
├── .github/           # Issue templates, PR template, CI workflows
├── .husky/            # Git hooks (pre-commit)
├── .vscode/           # VS Code extensions & settings
├── docs/              # Documentation
├── scripts/           # Code quality check scripts
├── src/               # Source code with demo components
├── package.json       # All dependencies configured
└── README.md          # Getting started guide

Cursor Commands

All templates include AI-powered Cursor commands for rapid scaffolding:

| Command | Description | | -------------------- | ----------------------------------------------------------------- | | scaffold-shell-app | Create a complete app shell with navbar, side navigation, routing | | trimble-id | Add Trimble Identity (TID) authentication with OAuth 2.0 / OIDC |

To use: Open Cursor IDE, press Cmd+K (Mac) or Ctrl+K (Windows/Linux), and run the command. The AI will guide you through a conversational setup flow.

The trimble-id command scaffolds a complete TID integration tailored to each framework: React uses @trimble-oss/trimble-id-react, SolidJS wraps the core TIDClient in a SolidJS context, and Angular uses @trimble-oss/trimble-id with a signals-based AuthService, functional route guard, and HTTP interceptor.

Architecture

┌─────────────────────────────────────────────────────────────┐
│                    npx create-trimble-app                   │
├─────────────────────────────────────────────────────────────┤
│  1. Parse CLI arguments (Commander.js)                      │
│  2. Show branded welcome header (boxen + Trimble Blue)      │
│  3. Check prerequisites (Git, Node.js 18+, npm)            │
│  4. GitHub account prompt (with guided signup)              │
│  5. Interactive prompts with threaded UI (@clack/prompts)   │
│  6. Copy bundled template (local file copy)                 │
│  7. Update package.json with project name                   │
│  8. Install dependencies silently (optional)                │
│  9. Validate template integrity (lint:all)                  │
│ 10. Show beginner-friendly success message                  │
└─────────────────────────────────────────────────────────────┘

For detailed architecture documentation, see docs/architecture.md.

Security

This CLI is designed with security as a priority:

• No External Downloads - Templates are bundled in the npm package
• Works Offline - No network required to create projects
• npm Provenance - Published with provenance attestation
• Minimal Dependencies - Only essential runtime dependencies

Unlike other scaffolding tools that download templates from GitHub at runtime, this CLI bundles templates directly. This eliminates:

• Supply chain attacks from compromised repositories
• Network failures during project creation
• Version drift between CLI and templates

Requirements

• Git - The CLI checks for Git and provides platform-specific install instructions if missing
• Node.js 18 or higher - Version is validated at startup with upgrade guidance
• npm, yarn, or pnpm

Development

# Clone this repository
git clone https://github.com/julianoczkowski/create-trimble-app.git
cd create-trimble-app

# Install dependencies
npm install

# Run locally
npm run dev

# Run tests
npm test

# Test specific commands
node bin/create-trimble-app.js --help
node bin/create-trimble-app.js my-app --framework react --dry-run
node bin/create-trimble-app.js my-app --framework solidjs --dry-run

For detailed testing instructions, see docs/local-testing.md.

Documentation

| Document | Description | | -------------------------------------- | ------------------------------ | | Architecture | How the CLI works internally | | Local Testing | How to test during development |

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Run tests (npm test)
4. Commit your changes (git commit -m 'Add some amazing feature')
5. Push to the branch (git push origin feature/amazing-feature)
6. Open a Pull Request

License

MIT © Julian Oczkowski

Issues & Discussions

Report bugs, request features, and discuss ideas:

• Support & Onboarding

Related

• Modus Web Components Documentation
• Modus Icons
• Trimble Modus Design System

Made with ❤️ for the Trimble community