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

# kit new

> Create a new Kit project

The `kit new` command creates a new Kit project with all the necessary files and directory structure.

## Usage

```bash theme={null}
kit new [name] [options]
```

## Arguments

| Argument | Description                                                     |
| -------- | --------------------------------------------------------------- |
| `name`   | The name of the project (optional, will prompt if not provided) |

## Options

| Option             | Description                       |
| ------------------ | --------------------------------- |
| `--no-interaction` | Skip all prompts and use defaults |
| `--no-git`         | Skip git initialization           |

## Examples

### Interactive Mode

```bash theme={null}
kit new
```

This will prompt you for:

* Project name
* Database type (SQLite, PostgreSQL, MySQL)
* Whether to include Inertia.js for frontend

### Quick Start

```bash theme={null}
kit new my-app
```

Creates a new project named "my-app" with interactive prompts for options.

### Non-Interactive Mode

```bash theme={null}
kit new my-app --no-interaction
```

Creates a project with all default settings:

* SQLite database
* Inertia.js frontend with React
* Git repository initialized

### Without Git

```bash theme={null}
kit new my-app --no-git
```

Creates the project without initializing a git repository.

## Generated Structure

```
my-app/
├── src/
│   ├── actions/           # Business logic actions
│   ├── controllers/       # HTTP controllers
│   ├── middleware/        # Custom middleware
│   ├── models/            # Database models
│   ├── config/            # Application configuration
│   ├── bootstrap.rs       # Service registration
│   ├── routes.rs          # Route definitions
│   └── main.rs            # Application entry point
├── frontend/              # Inertia.js frontend (if selected)
│   ├── src/
│   │   ├── pages/         # React page components
│   │   └── types/         # TypeScript types
│   ├── package.json
│   └── vite.config.ts
├── migrations/            # Database migrations
├── .env                   # Environment variables
├── .env.example           # Environment template
├── Cargo.toml             # Rust dependencies
└── README.md
```

## What's Included

* Pre-configured Axum web server
* SeaORM database integration
* Inertia.js with React (optional)
* TypeScript type generation
* Hot-reload development server
* Example controller, action, and middleware
* Database migration setup