- #16122
9a2113bThanks @matthewp! - Fixes dependency installation failing on Windows when using Bun as the package manager
- #16106
d241012Thanks @matthewp! - Fixes dependency installation failing on Windows when runningnpm create astro@latest. The previous fix for DEP0190 warnings incorrectly assumed.cmdshims could be spawned directly without a shell — on Windows,.cmdfiles requirecmd.exeto execute. Package manager commands are now invoked viacmd.exe /d /s /con Windows. Also fixes the[object Object]error message that appeared when installation failed, replacing it with the actual error.
- #15967
8db1f62Thanks @matthewp! - Warn when--yesis used with a third-party template to clarify that dependency installation may run lifecycle scripts.
- #15864
d3c7de9Thanks @florian-lefebvre! - Removes temporary support for Node >=20.19.1 because Stackblitz now uses Node 22 by default
- #15885
817afb6Thanks @matthewp! - Avoid spawning package manager commands withshell: trueto prevent Node.js DEP0190 warnings duringcreate-astroruns on newer Node versions.
- #14427
e131261Thanks @florian-lefebvre! - Increases minimum Node.js version to 22.12.0 - (v6 upgrade guidance)
-
#15344
9d87f77Thanks @matthewp! - Fixes a hang that could occur when the npm registry is slow or unresponsive by adding a 10 second timeout to the version check -
#15350
d758b68Thanks @matthewp! - Errors when--addand--no-installflags are used together, as--addrequires dependencies to be installed -
#15264
11efb05Thanks @florian-lefebvre! - Lower the Node version requirement to allow running on Stackblitz until it supports v22 -
#15419
a18d727Thanks @ematipico! - Fixes an issue where--addcould accept any kind of string, leading to different errors. Now--addaccepts only values of valid integrations and adapters. -
#15419
a18d727Thanks @ematipico! - Fixes an issue where theaddcommand could accept any arbitrary value, leading the possible command injections. Nowaddand--addaccepts values that are only acceptable npmjs.org names.
-
#15419
a18d727Thanks @ematipico! - Fixes an issue where--addcould accept any kind of string, leading to different errors. Now--addaccepts only values of valid integrations and adapters. -
#15419
a18d727Thanks @ematipico! - Fixes an issue where theaddcommand could accept any arbitrary value, leading the possible command injections. Nowaddand--addaccepts values that are only acceptable npmjs.org names.
-
#15344
9d87f77Thanks @matthewp! - Fixes a hang that could occur when the npm registry is slow or unresponsive by adding a 10 second timeout to the version check -
#15350
d758b68Thanks @matthewp! - Errors when--addand--no-installflags are used together, as--addrequires dependencies to be installed
- #15264
11efb05Thanks @florian-lefebvre! - Lower the Node version requirement to allow running on Stackblitz until it supports v22
- #14427
e131261Thanks @florian-lefebvre! - Increases minimum Node.js version to 22.12.0 - (v6 upgrade guidance)
- #14528
3597371Thanks @florian-lefebvre! - Fixes a case where a deprecation warning would be shown on Node 24
- #14158
89e9364Thanks @bjohansebas! - Prevents deprecation warnings in Node 24
-
#14115
270e009Thanks @ascorbic! - Removes "Open in x" badges from the README of the official Astro templates when a new project is created -
#14115
270e009Thanks @ascorbic! - Adds support for marking sections in template READMEs to be removed when thecreate astrocommand is used to create a new projectTheme authors can now use magic comments in template READMEs to mark sections that should not be included when a user runs
create-astrowith the--templateflag to create a new project.This allows templates to have content that is visible when viewed in the source repo but not when the template is copied for use in a new project. This is useful for content that is appropriate for a theme's own repository, but will not be useful to someone using the theme, such as an "Open this repository in StackBlitz" badge where the URL is hardcoded .
Use the magic comments
<!-- ASTRO:REMOVE:START -->and<!-- ASTRO:REMOVE:END -->to indicate content to be excluded from your README during thecreate astroprocess.<!-- ASTRO:REMOVE:START --> [](https://stackblitz.com/github/withastro/astro/tree/latest/examples/basics) <!-- ASTRO:REMOVE:END -->
Note that these comments only remove content when new projects are created using
create astro. When your theme template is forked, your README will be copied in its entirety.
- #12529
485c2f0Thanks @apatel369! - Fixes an issue where installing Astro beta usingcreate-astrodisplays the wrong Astro version in the installation messages.
-
#13809
3c3b492Thanks @ascorbic! - Increases minimum Node.js version to 18.20.8Node.js 18 has now reached end-of-life and should not be used. For now, Astro will continue to support Node.js 18.20.8, which is the final LTS release of Node.js 18, as well as Node.js 20 and Node.js 22 or later. We will drop support for Node.js 18 in a future release, so we recommend upgrading to Node.js 22 as soon as possible. See Astro's Node.js support policy for more details.
⚠️ Important note for users of Cloudflare Pages: The current build image for Cloudflare Pages uses Node.js 18.17.1 by default, which is no longer supported by Astro. If you are using Cloudflare Pages you should override the default Node.js version to Node.js 22. This does not affect users of Cloudflare Workers, which uses Node.js 22 by default.
- #13591
5dd2d3fThanks @florian-lefebvre! - Removes unused code
- #13636
a9fd03fThanks @sarah11918! - Updates the wording for choosing the "minimal" starter template options
- #13257
6012e06Thanks @ADTC! - Modify the template README file to reflect the correct package manager
-
#12083
9263e96Thanks @Princesseuh! - Reworks the experience of creating a new Astro project using thecreate astroCLI command.- Updates the list of templates to include Starlight and combines the "minimal" and "basics" templates into a new, refreshed "Basics" template to serve as the single, minimal Astro project starter.
- Removes the TypeScript question. Astro is TypeScript-only, so this question was often misleading. The "Strict" preset is now the default, but it can still be changed manually in
tsconfig.json. astro checkis no longer automatically added to the build script.- Added a new
--addflag to install additional integrations after creating a project. For example,pnpm create astro --add reactwill create a new Astro project and install the React integration.
- #12083
9263e96Thanks @Princesseuh! - Reworks the experience of creating a new Astro project using thecreate astroCLI command.- Updates the list of templates to include Starlight and combines the "minimal" and "basics" templates into a new, refreshed "Basics" template to serve as the single, minimal Astro project starter.
- Removes the TypeScript question. Astro is TypeScript-only, so this question was often misleading. The "Strict" preset is now the default, but it can still be changed manually in
tsconfig.json. astro checkis no longer automatically added to the build script.- Added a new
--addflag to install additional integrations after creating a project. For example,pnpm create astro --add reactwill create a new Astro project and install the React integration.
-
#12154
9988dd6Thanks @bluwy! - Improves default template download speed by downloading from a branch containing the template only -
#12186
49c4f64Thanks @Terfno! - Ensures new line at the end of the generatedpackage.jsonandtsconfig.jsonfiles
- #12143
2385d58Thanks @bluwy! - Uses@bluwy/giget-coreinstead ofgigetfor smaller installation size when downloading the CLI
- #11924
7d70ba3Thanks @florian-lefebvre! - Updates the default Astro config with// @ts-checkif the TypeScript preset isstrictorstrictest
-
#10689
683d51a5eecafbbfbfed3910a3f1fbf0b3531b99Thanks @ematipico! - Deprecate support for versions of Node.js older thanv18.17.1for Node.js 18, older thanv20.0.3for Node.js 20, and the complete Node.js v19 release line.This change is in line with Astro's Node.js support policy.
- #10487
2330f22d6cf8cd150c19ec40359aed4d6b43ddecThanks @satyarohith! - Fixes a case where a promise wasn't awaited, causing an issue in Deno.
- #10255
2aec2cdc21f48f9b4f1dd82e2fd16fa3d653ccc5Thanks @natemoo-re! - Fixes an issue where TypeScript and@astrojs/checkversions would occasionally print asundefined.
- #10117
51b6ff7403c1223b1c399e88373075972c82c24cThanks @hippotastic! - Fixes an issue wherecreate astro,astro addand@astrojs/upgradewould fail due to unexpected package manager CLI output.
- #9813
fecba30a1abb7ca65dfb8f506dde77117fa447d1Thanks @florian-lefebvre! - Fixes@astrojs/checkandtypescriptaddition topackage.jsondependencies when the user has decided not to auto-install dependencies
- #9476
651f45b4010ad9b8d9f61fdc748618e220fe5375Thanks @ElianCodes! - Improves seasonal message handling by automatically detecting the local date
- #9470
607303be198931825dac9f3bc97867b4886feaf3Thanks @onsclom! - Improves thecreate astroCLI experience by asking all the questions upfront, then creating your new Astro project based on your responses.
- #9105
6201bbe96Thanks @FredKSchott! - Stop clearing the console on start
- #9105
6201bbe96Thanks @FredKSchott! - Stop clearing the console on start
- #9048
1e97708cdThanks @skirianov! - Fixes an issue where a successful "Dependencies installed" message is displayed even when installing dependencies fails.
- #8959
6169b6e56Thanks @ElianCodes! - Undo the halloween theme and restorefancybehaviour
- #8911
b236d88adThanks @natemoo-re! - Ensure an existing template'spackage.jsonscriptsare respected when modifyingbuild.
- #8853
ce807a2bfThanks @rayriffy! - Automatically installs the required dependencies to run the astro check command when the user indicates they plan to write TypeScript.
- #8841
f2dd895d7Thanks @Genteure! - No longer attempts to delete the directory after a template download fails if the path is.,./or starts with../.
- #8846
3baab3d93Thanks @ElianCodes! - feat: make Houston wear scary hats and say new things for spooky season
- #8634
b64dd45c0Thanks @TheOtterlord! - Fix--yesbehaviour to prevent it overriding--template
- #8551
1d5b3f079Thanks @jacobthesheep! - Adds--yesanddry-runflags to project-name and theyesflag to template.
- #8456
ed952b4ceThanks @natemoo-re! - Improve startup performance by removing dependencies, lazily initializing async contextual values
-
#8427
b81ff8fceThanks @aswind7! - trim project name of the user input -
#8306
d2f2a11cdThanks @jacobthesheep! - Support detecting Bun when logging messages with package manager information.
- #8292
4e88ffd81Thanks @Princesseuh! - Correctly remove new.codesandboxfolder when copying template
-
#8188
d0679a666Thanks @ematipico! - Remove support for Node 16. The lowest supported version by Astro and all integrations is now v18.14.1. As a reminder, Node 16 will be deprecated on the 11th September 2023. -
#8179
6011d52d3Thanks @matthewp! - Astro 3.0 Release Candidate
-
#7944
dff0f0f8dThanks @colinhacks! - Update 'dev' command for Bun users -
#8102
e6e1de4f0Thanks @natemoo-re! - Verify internet connection and that--templateexists before continuing
1eae2e3f7Thanks @Princesseuh! - Remove support for Node 16. The lowest supported version by Astro and all integrations is now v18.14.1. As a reminder, Node 16 will be deprecated on the 11th September 2023.
-
#7944
dff0f0f8dThanks @colinhacks! - Update 'dev' command for Bun users -
#8102
e6e1de4f0Thanks @natemoo-re! - Verify internet connection and that--templateexists before continuing
- #8089
04755e846Thanks @natemoo-re! - Fix install step to avoid uncaught errors
- #8077
44cf30a25Thanks @natemoo-re! - Reduce dependency installation size, swapexecafor lightnode:child_processwrapper
- #8028
8292c4131Thanks @natemoo-re! - Improve yarn berry support
- #7939
89cd4b877Thanks @natemoo-re! - Handle error state for version number
- #7580
2ca5bdde2Thanks @sankethchebbi! - Update dependency installation grammar
-
#7527
9e2426f75Thanks @natemoo-re! - Default registry logic to fall back to NPM if registry command fails (sorry, Bun users!) -
#7539
1170877b5Thanks @jc1144096387! - Update registry logic, improving edge cases (http support, redirects, registries ending with '/')
- #7435
3f9f5c117Thanks @bholmesdev! - Fix registry failures using unexpected package managers when running create-astro
- #7326
1430ffb47Thanks @calebdwilliams! - Ensure create-astro respects package manager registry configuration
- #7277
229affca4Thanks @natemoo-re! - Addstarlighttemplate alias
- #7086
c5f1275e9Thanks @MoustaphaDev! - Fix create astro regression
- #7052
8c14bffbdThanks @ematipico! - Don't exit if dependencies fail to install
- #6682
335602344Thanks @andremralves! - add validation for non-printable characters
- #6677
4a3262060Thanks @bholmesdev! - Fix: Log an error when passing a--templatethat does not exist
- #6213
afbbc4d5bThanks @Princesseuh! - Updated compilation settings to disable downlevelling for Node 14
- #6375
754c5ca9aThanks @natemoo-re! - Respect originalpackage.jsonindentation
- #6352
c87c16cfaThanks @SerekKiri! - Add missing flags to help command
-
#6314
7f61e8fe3Thanks @MilesPernicious! - Prompt for git initialization last, so all configurations can get added to the initial commit -
#6294
d0dbee872Thanks @liruifengv! -create-astrohelp info add--typescriptflag
- #6278
0f5d122cdThanks @Princesseuh! - Revert to giget 1.0.0 until upstream issue is fixed
- #6266
066b4b4efThanks @natemoo-re! - Improve error handling during tasks that display a spinner
- #6082
8d2187d8bThanks @natemoo-re! - Redesignedcreate-astroexperience
- #5953
5c64324c0Thanks @ZermattChris! - Check for a preexisting .git directory and if found, skip trying to create a new one.
- #5958
d0d7f6118Thanks @natemoo-re! - Fix typescript prompt handling
- #5782
1f92d64eaThanks @Princesseuh! - Remove support for Node 14. Minimum supported Node version is now >=16.12.0
-
#5898
d8919b1a2Thanks @TheOtterlord! - Support headless runs with-y/--yes -
#5920
f27bb3d79Thanks @delucis! - Improve error message for third-party template 404s
See changes in 2.0.0-beta.1
See changes in 2.0.0-beta.0
- #5782
1f92d64eaThanks @Princesseuh! - Remove support for Node 14. Minimum supported Node version is now >=16.12.0
-
#5579
2c2c65297Thanks @yuhang-dong! - Upgrade giget to support env proxy config -
#5616
61302ab7aThanks @natemoo-re! - Skip Houston on Windows until we can debug the prompt issue
- #5404
505abfd64Thanks @liruifengv! - fix error when don't have template input
- #5319
b211eadefThanks @natemoo-re! - Fix bug withsetRawMode. Respect--skip-houstonin all cases.
-
#5240
d9be7e36bThanks @natemoo-re! - Improve error messages whencreate-astrofails -
#5226
641b6d7d5Thanks @natemoo-re! - Allow Windows users to pass--fancyto enable full unicode support
-
#5088
040837628Thanks @natemoo-re! - Introducing your new automated assistant: Houston! 🎉╭─────╮ Houston: │ ◠ ◡ ◠ Initiating launch sequence... right... now! ╰─────╯Updates template and TypeScript prompts for clarity and friendliness.
Migrates template copying from
degit(unmaintained) togigetfor stability.
- #4810
7481ffda0Thanks @mrienstra! - Always write chosen config totsconfig.json.- Before: Only when
strict&strictestwas selected - After: Also when
baseis selected (via "Relaxed" or "I prefer not to use TypeScript")
- Before: Only when
- #4439
77ce6be30Thanks @Princesseuh! - Add tsconfig templates for users to extend from
- #4439
77ce6be30Thanks @Princesseuh! - Add tsconfig templates for users to extend from
-
04ad44563- > Astro v1.0 is out! Read the official announcement post.No breaking changes. This package is now officially stable and compatible with
astro@1.0.0!
- #4183
77c018e51Thanks @Princesseuh! - Fix relaxed and default TypeScript settings not working
- #4179
d344f9e3eThanks @Princesseuh! - Add a step to configure how strict TypeScript should be
- #4075
cc10a5c8eThanks @Princesseuh! - Added better error handling when cancelling operations, providing bad templates and when there's a degit cache issue
- #3971
e6e216061Thanks @tony-sull! - Fixes support for using templates from any GitHub repository
- #3914
b48767985Thanks @ran-dall! - Rollback supportednode@16version. Minimum versions are nownode@14.20.0ornode@16.14.0.
- #3871
1cc5b7890Thanks @natemoo-re! - Update supportednodeversions. Minimum versions are nownode@14.20.0ornode@16.16.0.
- #3831
4fb08502Thanks @FredKSchott! - Small wording updates
- #3756
507cd5c8Thanks @bholmesdev! - Chore: remove create-astro install step test
- #3391
cf8015eaThanks @natemoo-re! - Fix #3309 default logger locale behavior.
- #3313
1a5335edThanks @bholmesdev! - Update "next steps" with more informative text on each CLI command. Oh, and gradients. A lot more gradients.
- #3227
c8f5fa35Thanks @bholmesdev! - Add "initialize git repository" step to simplify our next steps suggestion. We now give you a one-liner to easily paste in your terminal and start the dev server!
- #3223
b7cd6958Thanks @bholmesdev! - Replace the component framework selector with a new "run astro add" option. This unlocks integrations beyond components during your create-astro setup, including TailwindCSS and Partytown. This also replaces our previous "starter" template with a simplified "Just the basics" option.
- #3212
00fc1326Thanks @bholmesdev! - Simplify logging during welcome message and directory selection
- #3190
38e5e9e9Thanks @bholmesdev! - Feat: add option to install dependencies during setup. This respects the package manager used to run create-astro (ex. "yarn create astro" vs "pnpm create astro@latest").
- #3168
7c49194cThanks @bholmesdev! - Add prompt to choose a directory, now defaulting to a separate "./my-astro-site" instead of "." (current directory)
- #2843
1fdb63b5Thanks @JuanM04! - Automatically add integrationpeerDependenciesto scaffoldedpackage.jsonfiles
- #2843
1fdb63b5Thanks @JuanM04! - Automatically add integrationpeerDependenciesto scaffoldedpackage.jsonfiles
- #2429
fda857ebThanks @Mikkel-T! - Added an option to create-astro to use verbose logging which should help debug degit issues
- #2202
45cea6aeThanks @jonathantneal! - Officially drop support for Node v12. The minimum supported version is now Node v14.15+,
- #2150
d5ebd9d1Thanks @FredKSchott! - Fix create-astro export map entry
- #2124
c0f29bcfThanks @leosvelperez! - Parse --renderers flag correctly when passed to the create-astro cli
- 3e1bdb1a: Add a helpful message for the "could not find commit hash for ..." error
- 6c66d483: Fix issue with v7.x+ versions of npm init, which changed default flag handling
- 6c66d483: Fix issue with v7.x+ versions of npm init, which changed default flag handling
- d5fdeefe: Changes create-astro to pull examples from the latest branch
- 025f5e3f: Fix to revert change pointing create-astro at the latest branch
- 28f00566: Updates create-astro to use the latest branch
- 0eeb2534: change rm to unlink for node 12 compatibility
- 11a6f884: Added a check to see if the renderers array is empty and only show the message about using the templates default renderers if it isn't
- 24dce41c: Adds a new template 'minimal' which does not include a framework
- cf4c97cf: forced degit template extraction in case of non empty installation directory
- 6c52c92: Add warning when encountering 'zlib: unexpected end of file' error
- a7e6666: compile javascript to target Node v12.x
- bd18e14: Add support for Solid
- d45431d: create-astro does not fail when removing subdirectories
- bd18e14: Add support for Solid
- a7e6666: compile javascript to target Node v12.x
- d45431d: create-astro does not fail when removing subdirectories
- 36e104b: Use new client: prefix for component examples
- 5d5d67c: Update
create-astroto handle framework-specific logic based on user preference
-
d8ceff5: Allows using an external repo as a template
You can do this with the
--templateflag:npm init astro my-shopify --template cassidoo/shopify-react-astro
- b0e41ea: fix small output bugs
- f9f2da4: Add repository key to package.json for create-astro
- ab2972b: Update package.json engines for esm support
- d6a7349: fix issue with empty prompt
- 6bca7c8: Redesigned create-astro internals
- 6bca7c8: New UI