2021-05-03 17:15:13 +00:00
|
|
|
# create-astro
|
2021-05-03 18:26:10 +00:00
|
|
|
|
2021-05-03 17:15:13 +00:00
|
|
|
## Scaffolding for Astro projects
|
|
|
|
|
|
|
|
**With NPM:**
|
2021-05-03 18:26:10 +00:00
|
|
|
|
2021-05-03 17:15:13 +00:00
|
|
|
```bash
|
2022-09-16 17:40:06 +00:00
|
|
|
npm create astro@latest
|
2021-05-03 17:15:13 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
**With Yarn:**
|
2021-05-03 18:26:10 +00:00
|
|
|
|
2021-05-03 17:15:13 +00:00
|
|
|
```bash
|
|
|
|
yarn create astro
|
|
|
|
```
|
|
|
|
|
|
|
|
`create-astro` automatically runs in _interactive_ mode, but you can also specify your project name and template with command line arguments.
|
|
|
|
|
|
|
|
```bash
|
|
|
|
# npm 6.x
|
2023-02-06 16:19:37 +00:00
|
|
|
npm create astro@latest my-astro-project --template minimal
|
2021-05-03 17:15:13 +00:00
|
|
|
|
|
|
|
# npm 7+, extra double-dash is needed:
|
2023-02-06 16:19:37 +00:00
|
|
|
npm create astro@latest my-astro-project -- --template minimal
|
2021-05-03 17:15:13 +00:00
|
|
|
|
|
|
|
# yarn
|
2023-02-06 16:19:37 +00:00
|
|
|
yarn create astro my-astro-project --template minimal
|
2021-05-03 17:15:13 +00:00
|
|
|
```
|
2023-06-26 03:34:13 +00:00
|
|
|
|
2023-02-06 16:19:37 +00:00
|
|
|
[Check out the full list][examples] of example templates, available on GitHub.
|
2021-05-03 17:15:13 +00:00
|
|
|
|
2021-07-06 19:14:22 +00:00
|
|
|
You can also use any GitHub repo as a template:
|
|
|
|
|
|
|
|
```bash
|
2022-09-16 17:40:06 +00:00
|
|
|
npm create astro@latest my-astro-project -- --template cassidoo/shopify-react-astro
|
2021-07-06 19:14:22 +00:00
|
|
|
```
|
|
|
|
|
2021-06-10 16:30:48 +00:00
|
|
|
### CLI Flags
|
|
|
|
|
|
|
|
May be provided in place of prompts
|
|
|
|
|
2023-06-26 03:34:13 +00:00
|
|
|
| Name | Description |
|
|
|
|
| :--------------------------- | :----------------------------------------------------- |
|
|
|
|
| `--template <name>` | Specify your template. |
|
|
|
|
| `--install` / `--no-install` | Install dependencies (or not). |
|
|
|
|
| `--git` / `--no-git` | Initialize git repo (or not). |
|
|
|
|
| `--yes` (`-y`) | Skip all prompt by accepting defaults. |
|
|
|
|
| `--no` (`-n`) | Skip all prompt by declining defaults. |
|
|
|
|
| `--dry-run` | Walk through steps without executing. |
|
|
|
|
| `--skip-houston` | Skip Houston animation. |
|
|
|
|
| `--typescript <option>` | TypeScript option: `strict` / `strictest` / `relaxed`. |
|
2022-01-21 00:00:22 +00:00
|
|
|
|
2021-11-23 22:47:05 +00:00
|
|
|
[examples]: https://github.com/withastro/astro/tree/main/examples
|
2023-01-20 14:53:12 +00:00
|
|
|
[typescript]: https://github.com/withastro/astro/tree/main/packages/astro/tsconfigs
|