sunpeak new - sunpeak

Overview

The sunpeak new command creates a new sunpeak project with a minimal, convention-based structure for building MCP Apps.

npx sunpeak new

Usage

Create a new project interactively:

npx sunpeak new

Or specify a project name:

npx sunpeak new sunpeak-app

Or specify both project name and resources to include:

npx sunpeak new sunpeak-app review,carousel

Arguments

Argument	Description
`projectName`	Name of the project directory (optional, prompts if not provided)
`resources`	Comma or space-separated list of resources to include (optional, prompts if not provided)

What Gets Created

The framework includes:

Convention-based structure - Resources auto-discovered from src/resources/{name}/, tools from src/tools/, simulations from tests/simulations/
Tool files - Real tool handlers with Zod schemas in src/tools/
Pre-configured tooling - Vite, TypeScript, Tailwind CSS 4, Vitest
Development scripts - Ready-to-use dev, build, mcp, and test commands
Example components - Sample MCP Resources to get started quickly

Project Structure

sunpeak-app/
├── src/
│   ├── resources/
│   │   └── review/
│   │       └── review.tsx
│   ├── tools/
│   │   └── review-diff.ts
│   └── server.ts
├── tests/simulations/
│   └── review-diff.json
└── package.json

Next Steps

After creating your project:

Navigate to your project: cd sunpeak-app
Start the dev server: pnpm dev
Open http://localhost:3000 to see the inspector

Project Scaffold

Learn more about the project structure and available commands.

​Overview

​Usage

​Arguments

​What Gets Created

​Project Structure

​Next Steps