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

# ralphy new

> Create a new project under <workspace>/projects/<id>/ with a canonical layout. Lightweight on-ramp — pass a brief to seed BRIEF.md or just --id <slug> for an em

## Summary

```bash theme={"dark"}
ralphy new [options] [brief...]
```

**Common flags**

| Flag            | Description                                                    |
| --------------- | -------------------------------------------------------------- |
| `--id <slug>`   | Project id slug (default: derived from brief or YYMMDD-HHMMSS) |
| `--name <name>` | Display name (default: title-cased id)                         |
| `--brand <id>`  | Brand id (registry lookup)                                     |

**Example**

```bash theme={"dark"}
ralphy new "Spring 2026 ad for Acme dental floss"
```

<Expandable title="Full reference">
  **Flags**

  | Flag                     | Description                                                    |
  | ------------------------ | -------------------------------------------------------------- |
  | `--id <slug>`            | Project id slug (default: derived from brief or YYMMDD-HHMMSS) |
  | `--name <name>`          | Display name (default: title-cased id)                         |
  | `--brand <id>`           | Brand id (registry lookup)                                     |
  | `--persona <id>`         | Persona id (registry lookup)                                   |
  | `--template <id>`        | Template id                                                    |
  | `--platform <platform>`  | Target platform (default: "tiktok")                            |
  | `--aspect-ratio <ratio>` | Aspect ratio (default: "9:16")                                 |
  | `--duration <seconds>`   | Target duration in seconds                                     |
  | `-h, --help`             | display help for command                                       |

  **All examples**

  ```bash theme={"dark"}
  ralphy new "Spring 2026 ad for Acme dental floss"
  ralphy new --id summer-launch-001
  ralphy new "office-set walkthrough" --id office-walk-001
  ```
</Expandable>