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

# init

> Initialize a new `zopio` project

# init Command

The `init` command initializes a new `zopio` project with the recommended structure and configuration.

## Usage

```bash theme={"system"}
zopio init [options]
```

## Options

* `-t, --template <template>` - Template to use (default: "default")
* `-l, --locale <locale>` - Default locale for internationalization (default: "en")

## Examples

<CodeGroup>
  ```bash Default theme={"system"}
  zopio init
  ```

  ```bash Custom Template theme={"system"}
  zopio init --template fullstack
  ```

  ```bash Custom Locale theme={"system"}
  zopio init --locale tr
  ```
</CodeGroup>

## Project Structure

The init command creates a new `zopio` project with the following structure:

```
my-zopio-app/
├─ .zopio/                # Zopio configuration
├─ app/                   # Next.js application
│  ├─ [locale]/           # Locale-specific routes
│  ├─ api/                # API routes
│  └─ layout.tsx          # Root layout
├─ components/            # React components
├─ dictionaries/          # Translation files for next-international
│  ├─ en/
│  └─ tr/                 # If specified with --locale
├─ locales/               # Translation files for next-intl
│  ├─ en/
│  └─ tr/                 # If specified with --locale
├─ i18nConfig.ts          # Internationalization configuration
├─ languine.json          # Additional i18n configuration
├─ package.json           # Dependencies and scripts
└─ tsconfig.json          # TypeScript configuration
```

## Available Templates

1. **default** - Standard template with basic setup
2. **fullstack** - Complete setup with frontend and backend
3. **api** - API-only setup
4. **minimal** - Minimal setup with core features only

<Alert type="info">
  You can create custom templates by adding them to your project's `.zopio/templates/` directory.
</Alert>

## Supported Locales

The following locales are supported out of the box:

* **en** - English (default)
* **tr** - Turkish
* **es** - Spanish
* **de** - German

Additional locales can be added later using the `i18n` command.