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
|
|
|
|
npm init astro
|
|
|
|
```
|
|
|
|
|
|
|
|
**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
|
2021-06-08 15:10:56 +00:00
|
|
|
npm init astro my-astro-project --template starter
|
2021-05-03 17:15:13 +00:00
|
|
|
|
|
|
|
# npm 7+, extra double-dash is needed:
|
2021-06-08 15:10:56 +00:00
|
|
|
npm init astro my-astro-project -- --template starter
|
2021-05-03 17:15:13 +00:00
|
|
|
|
|
|
|
# yarn
|
2021-06-08 15:10:56 +00:00
|
|
|
yarn create astro my-astro-project --template starter
|
2021-05-03 17:15:13 +00:00
|
|
|
```
|
2021-06-10 16:30:48 +00:00
|
|
|
[Check out the full list][examples] of example starter templates, available on GitHub.
|
2021-05-03 17:15:13 +00:00
|
|
|
|
2021-06-10 16:30:48 +00:00
|
|
|
### CLI Flags
|
|
|
|
|
|
|
|
May be provided in place of prompts
|
|
|
|
|
|
|
|
| Name | Description |
|
|
|
|
|:-------------|:----------------------------------------------------|
|
|
|
|
| `--template` | Specify the template name ([list][examples]) |
|
|
|
|
| `--commit` | Specify a specific Git commit or branch to use from this repo (by default, `main` branch of this repo will be used) |
|
|
|
|
|
|
|
|
[examples]: https://github.com/snowpackjs/astro/tree/main/examples
|