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

# ubx init

> Scaffold a new ubx project.

`ubx init` creates a new ubx project directory with a `ubx.yaml` config file and a starter `stack.iac`.

## Usage

```bash theme={null}
ubx init [project-name]
```

## Example

```bash theme={null}
ubx init my-platform
cd my-platform
```

Creates:

```
my-platform/
  ubx.yaml      # project config
  stack.iac     # starter infrastructure file
  .ubxignore    # excludes .ubx/ from compilation
  .gitignore    # excludes .ubx/ from git
```

## Generated `ubx.yaml`

```yaml theme={null}
project:    my-platform
backend:    file://.ubx/state
defaultEnv: dev
```

## Generated `stack.iac`

```hcl theme={null}
input "env" {
  type    = "string"
  default = "dev"
}
```

## Next Steps

```bash theme={null}
ubx validate   # check for errors
ubx plan       # preview what will deploy
ubx apply      # deploy
```