astro/packages/create-astro
2023-01-26 12:02:14 -05:00
..
src [ci] format 2023-01-26 12:02:14 -05:00
test test(create-astro): correct wrong argument (#5812) 2023-01-11 00:57:16 +08:00
CHANGELOG.md [ci] release (beta) (#5792) 2023-01-12 11:40:35 -05:00
create-astro.mjs create-astro bug fixes (#5319) 2022-11-08 10:33:36 -06:00
package.json [ci] release (beta) (#5792) 2023-01-12 11:40:35 -05:00
README.md Add headless support to create-astro (#5898) 2023-01-26 12:02:14 -05:00
tsconfig.json Support Node v14.15+ (#2202) 2021-12-16 18:53:22 -05:00

create-astro

Scaffolding for Astro projects

With NPM:

npm create astro@latest

With Yarn:

yarn create astro

create-astro automatically runs in interactive mode, but you can also specify your project name and template with command line arguments.

# npm 6.x
npm create astro@latest my-astro-project --template starter

# npm 7+, extra double-dash is needed:
npm create astro@latest my-astro-project -- --template starter

# yarn
yarn create astro my-astro-project --template starter

Check out the full list of example starter templates, available on GitHub.

You can also use any GitHub repo as a template:

npm create astro@latest my-astro-project -- --template cassidoo/shopify-react-astro

CLI Flags

May be provided in place of prompts

Name Description
--template Specify the template name (list)
--commit Specify a specific Git commit or branch to use from this repo (by default, main branch of this repo will be used)
--fancy For Windows users, --fancy will enable full unicode support
--typescript Specify the tsconfig to use
--yes/-y Skip prompts and use default values

Debugging

To debug create-astro, you can use the --verbose flag which will log the output of degit and some more information about the command, this can be useful when you encounter an error and want to report it.

# npm 6.x
npm create astro@latest my-astro-project --verbose

# npm 7+, extra double-dash is needed:
npm create astro@latest my-astro-project -- --verbose

# yarn
yarn create astro my-astro-project --verbose