# allyhub site deploy

> Build a website here and upload it to AllyHub as a new version of its site, sending only the files AllyHub lacks; private until --live

Source: https://allyhub.com/docs/reference/cli/site-deploy · AllyHub 0.10.0
Index of all docs: https://allyhub.com/llms.txt

## Usage

```bash
allyhub site deploy [item] [options]
```

## Arguments

| Argument | Type | What it is |
| --- | --- | --- |
| `<item>` | string | The website: its id in allyhub.yaml or its file, when several are in the project. Left out, the project's one website |

## Options

| Option | Type | Default | What it does |
| --- | --- | --- | --- |
| `--slug` | string |  | The site's address, &lt;slug&gt;.allyhub.site, the first time; default from the website's folder |
| `--note` | string |  | What this version changes |
| `--live` | boolean |  | Make this version what the site's address serves |
| `--built` | boolean |  | Upload the output folder as it is, with no build |
| `--new` | boolean |  | Make a site of this team's for the folder, though website.json names another team's (theirs stays as it is) |

## Global options

`--dir <value>`: the project's folder; default the one around where it is run. `--json`: print the result as JSON.

## Output

With `--json`, the command prints an object with these fields:

| Field | Type | What it is |
| --- | --- | --- |
| `site` | object |  |
| `version` | string |  |
| `live` | boolean |  |
| `confirm` | string |  |
| `files` | number |  |
| `sent` | number |  |

## Examples

```bash
allyhub site deploy
allyhub site deploy website --slug acme --live
allyhub site deploy --note "New pricing" --live
```

## Exit codes

`0` when it succeeds; the others are listed in [Exit codes](https://allyhub.com/docs/reference/cli/exit-codes.md).

## In the work

**websites**: Making a website: any web project, with its website JSON listed in allyhub.yaml

[`check`](https://allyhub.com/docs/reference/cli/check.md) → [`render`](https://allyhub.com/docs/reference/cli/render.md) → [`frames web`](https://allyhub.com/docs/reference/cli/frames-web.md) → [`frames compare`](https://allyhub.com/docs/reference/cli/frames-compare.md) → `site deploy` → [`site status`](https://allyhub.com/docs/reference/cli/site-status.md) → [`site live`](https://allyhub.com/docs/reference/cli/site-live.md)
