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

# sunpeak new

> Create a new project with the sunpeak framework.

## Overview

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

```bash theme={null}
npx sunpeak new
```

## Usage

Create a new project interactively:

```bash theme={null}
npx sunpeak new
```

Or specify a project name:

```bash theme={null}
npx sunpeak new sunpeak-app
```

Or specify both project name and resources to include:

```bash theme={null}
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:

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

<Card horizontal title="Project Scaffold" icon="folder-tree" href="/app-framework/project-scaffold">
  Learn more about the project structure and available commands.
</Card>