astro/packages/create-astro/README.md

41 lines
1 KiB
Markdown
Raw Normal View History

# create-astro
2021-05-03 18:26:10 +00:00
## Scaffolding for Astro projects
**With NPM:**
2021-05-03 18:26:10 +00:00
```bash
npm init astro
```
**With Yarn:**
2021-05-03 18:26:10 +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
npm init astro my-astro-project --template starter
# npm 7+, extra double-dash is needed:
npm init astro my-astro-project -- --template starter
# yarn
yarn create astro my-astro-project --template starter
```
[Check out the full list][examples] of example starter templates, available on GitHub.
### 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