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

# Create Project

> Create a new SwiftUI-based Xcode project

Create a new Xcode project using FlowDeck's built-in SwiftUI template. Multi-platform targets (iOS, macOS, tvOS, watchOS, visionOS) are supported, depending on the SDKs installed in Xcode.

```bash theme={null}
# Create an iOS project in the current directory
flowdeck project create MyApp

# Create the project in a specific directory
flowdeck project create MyApp --path ~/Projects

# Create a multi-platform project
flowdeck project create MyApp --platforms ios,macos,visionos

# Include tvOS and watchOS
flowdeck project create MyApp --platforms ios,tvos,watchos

# Create an iOS app with a companion watchOS app
flowdeck project create MyApp --watch-companion

# Set a custom bundle identifier
flowdeck project create MyApp --bundle-id com.acme.MyApp

# Customize deployment targets
flowdeck project create MyApp --ios-target 17.0 --macos-target 14.0

# JSON output for automation
flowdeck project create MyApp --json
```

## Arguments

| Argument | Description              |
| -------- | ------------------------ |
| `<name>` | App name (e.g., `MyApp`) |

## Options

| Option                        | Short | Description                                                                               |
| ----------------------------- | ----- | ----------------------------------------------------------------------------------------- |
| `--bundle-id <id>`            | `-b`  | Bundle identifier (default: `com.example.<name>`)                                         |
| `--platforms <list>`          |       | Comma-separated platforms: `ios`, `macos`, `tvos`, `watchos`, `visionos` (default: `ios`) |
| `--path <path>`               | `-o`  | Output directory (default: current directory)                                             |
| `--ios-target <version>`      |       | iOS deployment target (default: 26.0)                                                     |
| `--macos-target <version>`    |       | macOS deployment target (default: 26.0)                                                   |
| `--tvos-target <version>`     |       | tvOS deployment target (default: 26.0)                                                    |
| `--watchos-target <version>`  |       | watchOS deployment target (default: 26.0)                                                 |
| `--visionos-target <version>` |       | visionOS deployment target (default: 26.0)                                                |
| `--watch-companion`           |       | Create iOS app with a companion watchOS app                                               |
| `--json`                      | `-j`  | Output as JSON                                                                            |

## JSON Output

```json theme={null}
{
  "schema": "flowdeck.project",
  "schemaVersion": "1.0.0",
  "success": true,
  "projectPath": "/Users/me/Projects/MyApp",
  "xcodeproj": "/Users/me/Projects/MyApp/MyApp.xcodeproj",
  "bundleIdentifier": "com.example.MyApp",
  "platforms": ["iOS"]
}
```