Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
43 KiB
create-astro
4.13.2
Patch Changes
- #14528
3597371Thanks @florian-lefebvre! - Fixes a case where a deprecation warning would be shown on Node 24
4.13.1
Patch Changes
- #14158
89e9364Thanks @bjohansebas! - Prevents deprecation warnings in Node 24
4.13.0
Minor Changes
-
#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.
4.12.1
Patch Changes
- #12529
485c2f0Thanks @apatel369! - Fixes an issue where installing Astro beta usingcreate-astrodisplays the wrong Astro version in the installation messages.
4.12.0
Minor Changes
-
#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.
4.11.4
Patch Changes
4.11.3
Patch Changes
- #13591
5dd2d3fThanks @florian-lefebvre! - Removes unused code
4.11.2
Patch Changes
- #13636
a9fd03fThanks @sarah11918! - Updates the wording for choosing the "minimal" starter template options
4.11.1
Patch Changes
- #13257
6012e06Thanks @ADTC! - Modify the template README file to reflect the correct package manager
4.11.0
Minor Changes
-
#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.
4.11.0-beta.1
Minor Changes
4.11.0-beta.0
Minor Changes
- #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.
4.10.0
Minor Changes
-
#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
4.9.2
Patch Changes
- #12143
2385d58Thanks @bluwy! - Uses@bluwy/giget-coreinstead ofgigetfor smaller installation size when downloading the CLI
4.9.1
Patch Changes
4.9.0
Minor Changes
- #11924
7d70ba3Thanks @florian-lefebvre! - Updates the default Astro config with// @ts-checkif the Typescript preset isstrictorstrictest
4.8.4
Patch Changes
4.8.3
Patch Changes
4.8.2
Patch Changes
4.8.1
Patch Changes
4.8.0
Minor Changes
-
#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.
4.7.5
Patch Changes
- #10487
2330f22d6cf8cd150c19ec40359aed4d6b43ddecThanks @satyarohith! - Fixes a case where a promise wasn't awaited, causing an issue in Deno.
4.7.4
Patch Changes
- #10255
2aec2cdc21f48f9b4f1dd82e2fd16fa3d653ccc5Thanks @natemoo-re! - Fixes an issue where TypeScript and@astrojs/checkversions would occasionally print asundefined.
4.7.3
Patch Changes
- #10117
51b6ff7403c1223b1c399e88373075972c82c24cThanks @hippotastic! - Fixes an issue wherecreate astro,astro addand@astrojs/upgradewould fail due to unexpected package manager CLI output.
4.7.2
Patch Changes
- #9813
fecba30a1abb7ca65dfb8f506dde77117fa447d1Thanks @florian-lefebvre! - Fixes@astrojs/checkandtypescriptaddition topackage.jsondependencies when the user has decided not to auto-install dependencies
4.7.1
Patch Changes
- #9476
651f45b4010ad9b8d9f61fdc748618e220fe5375Thanks @ElianCodes! - Improves seasonal message handling by automatically detecting the local date
4.7.0
Minor Changes
- #9470
607303be198931825dac9f3bc97867b4886feaf3Thanks @onsclom! - Improves thecreate astroCLI experience by asking all the questions upfront, then creating your new Astro project based on your responses.
4.6.0
Minor Changes
4.5.2
Patch Changes
- #9105
6201bbe96Thanks @FredKSchott! - Stop clearing the console on start
4.5.2-beta.0
Patch Changes
- #9105
6201bbe96Thanks @FredKSchott! - Stop clearing the console on start
4.5.1
Patch Changes
- #9048
1e97708cdThanks @skirianov! - Fixes an issue where a successful "Dependencies installed" message is displayed even when installing dependencies fails.
4.5.0
Minor Changes
- #8959
6169b6e56Thanks @ElianCodes! - Undo the halloween theme and restorefancybehaviour
Patch Changes
4.4.1
Patch Changes
- #8911
b236d88adThanks @natemoo-re! - Ensure an existing template'spackage.jsonscriptsare respected when modifyingbuild.
4.4.0
Minor Changes
- #8853
ce807a2bfThanks @rayriffy! - Automatically installs the required dependencies to run the astro check command when the user indicates they plan to write TypeScript.
Patch Changes
- #8841
f2dd895d7Thanks @Genteure! - No longer attempts to delete the directory after a template download fails if the path is.,./or starts with../.
4.3.0
Minor Changes
- #8846
3baab3d93Thanks @ElianCodes! - feat: make Houston wear scary hats and say new things for spooky season
4.2.1
Patch Changes
- #8634
b64dd45c0Thanks @TheOtterlord! - Fix--yesbehaviour to prevent it overriding--template
4.2.0
Minor Changes
- #8551
1d5b3f079Thanks @jacobthesheep! - Adds--yesanddry-runflags to project-name and theyesflag to template.
4.1.0
Minor Changes
- #8456
ed952b4ceThanks @natemoo-re! - Improve startup performance by removing dependencies, lazily initializing async contextual values
4.0.2
Patch Changes
-
#8427
b81ff8fceThanks @aswind7! - trim project name of the user input -
#8306
d2f2a11cdThanks @jacobthesheep! - Support detecting Bun when logging messages with package manager information.
4.0.1
Patch Changes
- #8292
4e88ffd81Thanks @Princesseuh! - Correctly remove new.codesandboxfolder when copying template
4.0.0
Major Changes
-
#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
4.0.0-rc.2
Major Changes
4.0.0-beta.1
Patch Changes
-
#7944
dff0f0f8dThanks @colinhacks! - Update 'dev' command for Bun users -
#8102
e6e1de4f0Thanks @natemoo-re! - Verify internet connection and that--templateexists before continuing
4.0.0-beta.0
Major Changes
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.
3.2.2
Patch Changes
-
#7944
dff0f0f8dThanks @colinhacks! - Update 'dev' command for Bun users -
#8102
e6e1de4f0Thanks @natemoo-re! - Verify internet connection and that--templateexists before continuing
3.2.1
Patch Changes
- #8089
04755e846Thanks @natemoo-re! - Fix install step to avoid uncaught errors
3.2.0
Minor Changes
- #8077
44cf30a25Thanks @natemoo-re! - Reduce dependency installation size, swapexecafor lightnode:child_processwrapper
3.1.13
Patch Changes
- #8028
8292c4131Thanks @natemoo-re! - Improve yarn berry support
3.1.12
Patch Changes
3.1.11
Patch Changes
- #7939
89cd4b877Thanks @natemoo-re! - Handle error state for version number
3.1.10
Patch Changes
- #7580
2ca5bdde2Thanks @sankethchebbi! - Update dependency installation grammar
3.1.9
Patch Changes
-
#7527
9e2426f75Thanks @natemoo-re! - Default registry logic to fallback to NPM if registry command fails (sorry, Bun users!) -
#7539
1170877b5Thanks @jc1144096387! - Update registry logic, improving edge cases (http support, redirects, registries ending with '/')
3.1.8
Patch Changes
- #7435
3f9f5c117Thanks @bholmesdev! - Fix registry failures using unexpected package managers when running create-astro
3.1.7
Patch Changes
- #7326
1430ffb47Thanks @calebdwilliams! - Ensure create-astro respects package manager registry configuration
3.1.6
Patch Changes
- #7277
229affca4Thanks @natemoo-re! - Addstarlighttemplate alias
3.1.5
Patch Changes
- #7086
c5f1275e9Thanks @MoustaphaDev! - Fix create astro regression
3.1.4
Patch Changes
- #7052
8c14bffbdThanks @ematipico! - Don't exit if dependencies fail to install
3.1.3
Patch Changes
- #6682
335602344Thanks @andremralves! - add validation for non-printable characters
3.1.2
Patch Changes
- #6677
4a3262060Thanks @bholmesdev! - Fix: Log an error when passing a--templatethat does not exist
3.1.1
Patch Changes
3.1.0
Minor Changes
- #6213
afbbc4d5bThanks @Princesseuh! - Updated compilation settings to disable downlevelling for Node 14
3.0.5
Patch Changes
- #6375
754c5ca9aThanks @natemoo-re! - Respect originalpackage.jsonindentation
3.0.4
Patch Changes
- #6352
c87c16cfaThanks @SerekKiri! - Add missing flags to help command
3.0.3
Patch Changes
-
#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
3.0.2
Patch Changes
- #6278
0f5d122cdThanks @Princesseuh! - Revert to giget 1.0.0 until upstream issue is fixed
3.0.1
Patch Changes
- #6266
066b4b4efThanks @natemoo-re! - Improve error handling during tasks that display a spinner
3.0.0
Major Changes
- #6082
8d2187d8bThanks @natemoo-re! - Redesignedcreate-astroexperience
2.0.2
Patch Changes
- #5953
5c64324c0Thanks @ZermattChris! - Check for a pre-existing .git directory and if found, skip trying to create a new one.
2.0.1
Patch Changes
- #5958
d0d7f6118Thanks @natemoo-re! - Fix typescript prompt handling
2.0.0
Major Changes
- #5782
1f92d64eaThanks @Princesseuh! - Remove support for Node 14. Minimum supported Node version is now >=16.12.0
Patch Changes
-
#5898
d8919b1a2Thanks @TheOtterlord! - Support headless runs with-y/--yes -
#5920
f27bb3d79Thanks @delucis! - Improve error message for third-party template 404s
2.0.0-beta.1
See changes in 2.0.0-beta.1
Patch Changes
2.0.0-beta.0
See changes in 2.0.0-beta.0
Major Changes
- #5782
1f92d64eaThanks @Princesseuh! - Remove support for Node 14. Minimum supported Node version is now >=16.12.0
1.2.4
Patch Changes
-
#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
1.2.3
Patch Changes
- #5404
505abfd64Thanks @liruifengv! - fix error when don't have template input
1.2.2
Patch Changes
- #5319
b211eadefThanks @natemoo-re! - Fix bug withsetRawMode. Respect--skip-houstonin all cases.
1.2.1
Patch Changes
-
#5240
d9be7e36bThanks @natemoo-re! - Improve error messages whencreate-astrofails -
#5226
641b6d7d5Thanks @natemoo-re! - Allow Windows users to pass--fancyto enable full unicode support
1.2.0
Minor Changes
-
#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.
1.1.0
Minor Changes
- #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
1.0.2
Patch Changes
1.0.1
Patch Changes
- #4439
77ce6be30Thanks @Princesseuh! - Add tsconfig templates for users to extend from
1.0.1-next.0
Patch Changes
- #4439
77ce6be30Thanks @Princesseuh! - Add tsconfig templates for users to extend from
1.0.0
Major Changes
-
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!
0.15.1
Patch Changes
- #4183
77c018e51Thanks @Princesseuh! - Fix relaxed and default TypeScript settings not working
0.15.0
Minor Changes
- #4179
d344f9e3eThanks @Princesseuh! - Add a step to configure how strict TypeScript should be
0.14.3
Patch Changes
- #4075
cc10a5c8eThanks @Princesseuh! - Added better error handling when cancelling operations, providing bad templates and when there's a degit cache issue
0.14.2
Patch Changes
- #3971
e6e216061Thanks @tony-sull! - Fixes support for using templates from any GitHub repository
0.14.1
Patch Changes
0.14.0
Minor Changes
- #3914
b48767985Thanks @ran-dall! - Rollback supportednode@16version. Minimum versions are nownode@14.20.0ornode@16.14.0.
0.13.0
Minor Changes
- #3871
1cc5b7890Thanks @natemoo-re! - Update supportednodeversions. Minimum versions are nownode@14.20.0ornode@16.16.0.
Patch Changes
0.12.5
Patch Changes
- #3831
4fb08502Thanks @FredKSchott! - Small wording updates
0.12.4
Patch Changes
- #3756
507cd5c8Thanks @bholmesdev! - Chore: remove create-astro install step test
0.12.3
Patch Changes
0.12.2
Patch Changes
- #3391
cf8015eaThanks @natemoo-re! - Fix #3309 default logger locale behavior.
0.12.1
Patch Changes
- #3313
1a5335edThanks @bholmesdev! - Update "next steps" with more informative text on each CLI command. Oh, and gradients. A lot more gradients.
0.12.0
Minor Changes
- #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!
0.11.0
Minor Changes
- #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.
0.10.1
Patch Changes
- #3212
00fc1326Thanks @bholmesdev! - Simplify logging during welcome message and directory selection
0.10.0
Minor Changes
- #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").
0.9.0
Minor Changes
- #3168
7c49194cThanks @bholmesdev! - Add prompt to choose a directory, now defaulting to a separate "./my-astro-site" instead of "." (current directory)
0.8.0
Minor Changes
- #2843
1fdb63b5Thanks @JuanM04! - Automatically add integrationpeerDependenciesto scaffoldedpackage.jsonfiles
0.8.0-next.0
Minor Changes
- #2843
1fdb63b5Thanks @JuanM04! - Automatically add integrationpeerDependenciesto scaffoldedpackage.jsonfiles
0.7.1
Patch Changes
- #2429
fda857ebThanks @Mikkel-T! - Added an option to create-astro to use verbose logging which should help debug degit issues
0.7.0
Minor Changes
- #2202
45cea6aeThanks @jonathantneal! - Officially drop support for Node v12. The minimum supported version is now Node v14.15+,
0.6.10
Patch Changes
- #2150
d5ebd9d1Thanks @FredKSchott! - Fix create-astro export map entry
0.6.9
Patch Changes
- #2124
c0f29bcfThanks @leosvelperez! - Parse --renderers flag correctly when passed to the create-astro cli
0.6.8
Patch Changes
3e1bdb1a: Add a helpful message for the "could not find commit hash for ..." error
0.6.7
0.6.7-next.1
Patch Changes
6c66d483: Fix issue with v7.x+ versions of npm init, which changed default flag handling
0.6.7-next.0
Patch Changes
6c66d483: Fix issue with v7.x+ versions of npm init, which changed default flag handling
0.6.6
Patch Changes
d5fdeefe: Changes create-astro to pull examples from the latest branch
0.6.5
Patch Changes
025f5e3f: Fix to revert change pointing create-astro at the latest branch
0.6.4
Patch Changes
28f00566: Updates create-astro to use the latest branch
0.6.3
Patch Changes
0eeb2534: change rm to unlink for node 12 compatibility
0.6.2
Patch Changes
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
0.6.1
Patch Changes
24dce41c: Adds a new template 'minimal' which does not include a framework
0.6.0
Minor Changes
cf4c97cf: forced degit template extraction in case of non empty installation directory
0.5.2
Patch Changes
6c52c92: Add warning when encountering 'zlib: unexpected end of file' error
0.5.1
Patch Changes
a7e6666: compile javascript to target Node v12.xbd18e14: Add support for Solidd45431d: create-astro does not fail when removing subdirectories
0.5.1-next.1
Patch Changes
0.5.1-next.0
Patch Changes
a7e6666: compile javascript to target Node v12.xd45431d: create-astro does not fail when removing subdirectories
0.5.0
Minor Changes
36e104b: Use new client: prefix for component examples
0.4.0
Minor Changes
5d5d67c: Updatecreate-astroto handle framework-specific logic based on user preference
0.3.5
Patch Changes
-
d8ceff5: Allows using an external repo as a templateYou can do this with the
--templateflag:npm init astro my-shopify --template cassidoo/shopify-react-astro
0.3.4
Patch Changes
b0e41ea: fix small output bugs
0.3.3
Patch Changes
f9f2da4: Add repository key to package.json for create-astro
0.3.2
Patch Changes
ab2972b: Update package.json engines for esm support
0.3.1
Patch Changes
d6a7349: fix issue with empty prompt