> Index of every page on this site: [llms.txt](https://docs.a-line.cloud/llms.txt)

# Your first project

> A cluster, a project and one app, as three YAML files.

Three files describe a cluster with one general-purpose pool, a project on it
and a web app in that project.

## The cluster

The file name is the cluster's name. A cluster needs a control-plane pool and
at least one pool for apps.

```yaml title="clusters/hetzner-fsn1.yaml" iac
# yaml-language-server: $schema=https://a-line.cloud/schemas/iac/v1.json
version: 1
provider: hetzner
region: fsn1
pools:
  - name: control-plane
    role: control_plane
  - name: general
```

## The project

A project groups apps and names the cluster they run on.

```yaml title="projects/web/project.yaml" iac
# yaml-language-server: $schema=https://a-line.cloud/schemas/iac/v1.json
version: 1
name: web
cluster: hetzner-fsn1
```

## The app

The app runs on the `general` pool and listens on port 8080.

```yaml title="projects/web/apps/site.yaml" iac
# yaml-language-server: $schema=https://a-line.cloud/schemas/iac/v1.json
version: 1
pool: general
port: 8080
```

See the [app file reference](/iac/reference/app-file) for every field.

## Try it

Change the app file and see what the schema says, as an editor with the modeline would. Pick another
file kind to try the cluster or project file.

<IacPlayground />
