AstroEco is Releasing…
Example: Displaying GitHub releases using astro-loader-github-releases
Patch Changes
- #12361
3d89e62Thanks @LunaticMuch! - Upgrades theesbuildversion to matchvite
Minor Changes
-
#12924
3caa337Thanks @florian-lefebvre! - Updates how the output is determined increateRedirectsFromAstroRoutes. Sincev0.5.0, the output would use thebuildOutputproperty andconfig.outputas a fallback. It no longer uses this fallback. -
#12924
3caa337Thanks @florian-lefebvre! - Updates the input requirements ofcreateRedirectsFromAstroRoutes:routeToDynamicTargetMapkeys areIntegrationResolvedRouteinstead ofIntegrationRouteData(obtained from theastro:routes:resolvedhook)- There's a new
assetsproperty, that can be obtained from theastro:build:donehook
function myIntegration() { let routes; let buildOutput; let config; return { name: 'my-integration', hooks: { 'astro:routes:resolved': (params) => { routes = params.routes; }, 'astro:config:done': (params) => { buildOutput = params.buildOutput; config = params.config; }, 'astro:build:done': (params) => { const redirects = createRedirectsFromAstroRoutes({ config, buildOutput, routeToDynamicTargetMap: new Map(routes.map((route) => [route, ''])), dir: params.dir, assets: params.assets, }); }, }, }; }
Patch Changes
- #12904
7fdbd43Thanks @florian-lefebvre! - Fixes the type offorce
Patch Changes
-
#12798
7b0cb85Thanks @ascorbic! - Improves warning logs for invalid content collection configuration -
#12781
96c4b92Thanks @ascorbic! - Fixes a regression that causeddefault()to not work withreference() -
#12820
892dd9fThanks @ascorbic! - Fixes a bug that caused cookies to not be deleted when destroying a session -
#12864
440d8a5Thanks @kaytwo! - Fixes a bug where the session ID wasn't correctly regenerated -
#12768
524c855Thanks @ematipico! - Fixes an issue where Astro didn't print error logs when Astro Islands were used in incorrect cases. -
#12814
f12f111Thanks @ematipico! - Fixes an issue where Astro didn't log anything in case a file isn't created during the build. -
#12875
e109002Thanks @ascorbic! - Fixes a bug in emulated legacy collections where the entry passed to the getCollection filter function did not include the legacy entry fields. -
#12768
524c855Thanks @ematipico! - Fixes an issue where Astro was printing the incorrect output format when running theastro buildcommand -
#12810
70a9f0bThanks @louisescher! - Fixes server islands failing to check content-type header under certain circumstancesSometimes a reverse proxy or similar service might modify the content-type header to include the charset or other parameters in the media type of the response. This previously wasn't handled by the client-side server island script and thus removed the script without actually placing the requested content in the DOM. This fix makes it so the script checks if the header starts with the proper content type instead of exactly matching
text/html, so the following will still be considered a valid header:text/html; charset=utf-8 -
#12816
7fb2184Thanks @ematipico! - Fixes an issue where an injected route entrypoint wasn't correctly marked because the resolved file path contained a query parameter.This fixes some edge case where some injected entrypoint were not resolved when using an adapter.
Minor Changes
- #12768
524c855Thanks @ematipico! - Adds a newbuildOutputproperty to the APIcreateRedirectsFromAstroRoutes
Patch Changes
- #12829
ebe2aa9Thanks @SapphicMoe! - Revert incorrect Content-Type header applied for RSS XML file
🚨 Breaking Changes
- layout: Update
StandardLayout, removeWideLayout& addFEATURE.slideEnterAnimoption - by @lin-stephanie in #9 (02528)
🚀 Features
- mobile:
- Support for TOC on mobile devices - by @lin-stephanie in #7 (c4d11)
- Refine toc and nav panel styles - by @lin-stephanie (d8e58)
- page:
- Add
/releasespage to display personal GitHub releases - by @lin-stephanie in #3 (39575) - Add
/prspage to display personal GitHub PRs - by @lin-stephanie in #8 (e7f47)
- Add
🐞 Bug Fixes
- Add reduced motion support to
toggleFadeEffect& add sorting for PRs inGithubView& refine style - by @lin-stephanie (ac035)
View changes on GitHub
Patch Changes
- Refine handling for
linkTextType: 'domain-path'(743512a)
Patch Changes
- Use UTC methods in date calculations for consistency (
0e0ca6f)
Patch Changes
- Use UTC methods in date calculations for consistency (
0e0ca6f)
Minor Changes
-
#12441
b4fec3cThanks @ascorbic! - Adds experimental session supportSessions are used to store user state between requests for server-rendered pages, such as login status, shopping cart contents, or other user-specific data.
--- export const prerender = false; // Not needed in 'server' mode const cart = await Astro.session.get('cart'); --- <a href="/checkout">🛒 {cart?.length ?? 0} items</a>
Sessions are available in on-demand rendered/SSR pages, API endpoints, actions and middleware. To enable session support, you must configure a storage driver.
If you are using the Node.js adapter, you can use the
fsdriver to store session data on the filesystem:// astro.config.mjs { adapter: node({ mode: 'standalone' }), experimental: { session: { // Required: the name of the unstorage driver driver: "fs", }, }, }
If you are deploying to a serverless environment, you can use drivers such as
redis,netlify-blobs,vercel-kv, orcloudflare-kv-bindingand optionally pass additional configuration options.For more information, including using the session API with other adapters and a full list of supported drivers, see the docs for experimental session support. For even more details, and to leave feedback and participate in the development of this feature, the Sessions RFC.
-
#12426
3dc02c5Thanks @oliverlynch! - Improves asset caching of remote imagesAstro will now store entity tags and the Last-Modified date for cached remote images and use them to revalidate the cache when it goes stale.
-
#12721
c9d5110Thanks @florian-lefebvre! - Adds a newgetActionPath()helper available fromastro:actionsAstro 5.1 introduces a new helper function,
getActionPath()to give you more flexibility when calling your action.Calling
getActionPath()with your action returns its URL path so you can make afetch()request with custom headers, or use your action with an API such asnavigator.sendBeacon(). Then, you can handle the custom-formatted returned data as needed, just as if you had called an action directly.This example shows how to call a defined
likeaction passing theAuthorizationheader and thekeepaliveoption:<script> // src/components/my-component.astro import { actions, getActionPath } from 'astro:actions'; await fetch(getActionPath(actions.like), { method: 'POST', headers: { 'Content-Type': 'application/json', Authorization: 'Bearer YOUR_TOKEN', }, body: JSON.stringify({ id: 'YOUR_ID' }), keepalive: true, }); </script>
This example shows how to call the same
likeaction using thesendBeaconAPI:<script> // src/components/my-component.astro import { actions, getActionPath } from 'astro:actions'; navigator.sendBeacon( getActionPath(actions.like), new Blob([JSON.stringify({ id: 'YOUR_ID' })], { type: 'application/json', }), ); </script>
Patch Changes
-
#12786
e56af4aThanks @ematipico! - Fixes an issue where Astro i18n didn't properly show the 404 page when using fallback and the optionprefixDefaultLocaleset totrue. -
#12758
483da89Thanks @delucis! - Adds types for?url&inlineand?url&no-inlineimport queries added in Vite 6 -
#12763
8da2318Thanks @rbsummers! - Fixed changes to vite configuration made in the astro:build:setup integration hook having no effect when target is "client" -
#12767
36c1e06Thanks @ascorbic! - Clears the content layer cache when the Astro config is changed
Patch Changes
-
#2717
c5fcbb3Thanks @delucis! - Fixes a list item spacing issue where line break elements (<br>) could receive a margin, breaking layout in Firefox -
#2724
02d7ac6Thanks @dionysuzx! - Adds social link support for Farcaster -
#2635
ec4b851Thanks @HiDeoo! - Fixes an issue where the language picker in multilingual sites could display the wrong language when navigating between pages with the browser back/forward buttons.
Minor Changes
-
#2612
8d5a4e8Thanks @HiDeoo! - Adds support for Astro v5, drops support for Astro v4.Upgrade Astro and dependencies
⚠️ BREAKING CHANGE: Astro v4 is no longer supported. Make sure you update Astro and any other official integrations at the same time as updating Starlight:npx @astrojs/upgrade
Community Starlight plugins and Astro integrations may also need to be manually updated to work with Astro v5. If you encounter any issues, please reach out to the plugin or integration author to see if it is a known issue or if an updated version is being worked on.
Update your collections
⚠️ BREAKING CHANGE: Starlight's internal content collections, which organize, validate, and render your content, have been updated to use Astro's new Content Layer API and require configuration changes in your project.-
Move the content config file. This file no longer lives within the
src/content/config.tsfolder and should now exist atsrc/content.config.ts. -
Edit the collection definition(s). To update the
docscollection, aloaderis now required:// src/content.config.ts import { defineCollection } from "astro:content"; +import { docsLoader } from "@astrojs/starlight/loaders"; import { docsSchema } from "@astrojs/starlight/schema"; export const collections = { - docs: defineCollection({ schema: docsSchema() }), + docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }), };If you are using the
i18ncollection to provide translations for additional languages you support or override our default labels, you will need to update the collection definition in a similar way and remove the collectiontypewhich is no longer available:// src/content.config.ts import { defineCollection } from "astro:content"; +import { docsLoader, i18nLoader } from "@astrojs/starlight/loaders"; import { docsSchema, i18nSchema } from "@astrojs/starlight/schema"; export const collections = { - docs: defineCollection({ schema: docsSchema() }), + docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }), - i18n: defineCollection({ type: 'data', schema: i18nSchema() }), + i18n: defineCollection({ loader: i18nLoader(), schema: i18nSchema() }), }; -
Update other collections. To update any other collections you may have, follow the “Updating existing collections” section in the Astro 5 upgrade guide.
If you are unable to make any changes to your collections at this time, including Starlight's default
docsandi18ncollections, you can enable thelegacy.collectionsflag to upgrade to v5 without updating your collections. This legacy flag exists to provide temporary backwards compatibility, and will allow you to keep your collections in their current state until the legacy flag is no longer supported. -
Patch Changes
-
#2669
310df7dThanks @aaronperezaguilera! - Adds Catalan UI translations -
#2664
62ff007Thanks @HiDeoo! - Publishes provenance containing verifiable data to link a package back to its source repository and the specific build instructions used to publish it. -
#2670
0223b42Thanks @aaronperezaguilera! - Adds Spanish UI translations for the Pagefind search modal
Patch Changes
- Refine logger output and update docs (
f3c237d)
Minor Changes (38cf8fc)
- In
userCommitmode, addrepoOwnerfield and renamedrepoNametorepoNameWithOwner(the originalrepoNameonly represented the repository name) - In
repoListmode, addversionNumandrepoOwnerfields - In
repoListmode, when configured withentryReturnType: 'byRelease', support returning the<Content />component viarender(entry)to render the published content - Errors no longer force the entire Astro project to terminate
- No longer calls
store.clear()internally
Minor Changes (25f92a8)
- Add
monthsBackoption to specify the recent months for loading pull requests - Support returning the
<Content />component viarender(entry)to render the PR content - Errors no longer force the entire Astro project to terminate
- No longer calls
store.clear()internally
Patch Changes
-
#2642
12750aeThanks @dragomano! - Updates Russian UI translations -
#2656
4d543beThanks @HiDeoo! - Improves error message when an invalid configuration or no configuration is provided to the Starlight integration. -
#2645
cf12bebThanks @techfg! - Fixes support for favicon URLs that contain a search query and/or hash -
#2650
38db4ecThanks @raviqqe! - Moves@types/js-yamlpackage to non-dev dependencies -
#2633
5adb720Thanks @HiDeoo! - Fixes a VoiceOver issue with Safari where the content of a<script>element could be read before the sidebar content. -
#2663
34755f9Thanks @astrobot-houston! - Adds a newseti:viteicon for Vite configuration files in the<FileTree>component
Patch Changes
- Add data type validation for JSON-stored tweets and update docs (
dde3e92)
Minor Changes
- Support for persisting the loaded tweets to a JSON file at a custom path, see details (
c0c6f6c)
Minor Changes
- #12678
97c9265Thanks @bskimball! - Add React 19 stable to peer dependencies
Patch Changes
- #12694
495f46bThanks @ematipico! - Fixes a bug where the experimental featureexperimental.svgwas incorrectly used when generating ESM images
Minor Changes
- Add
newlineHandlingoption to specify\nprocessing intext_htmlgeneration (2542879)
Patch Changes
-
#12646
f13417bThanks @bluwy! - Avoids parsing frontmatter that are not at the top of a file -
#12570
87231b1Thanks @GrimLink! - Removes trailing new line in code blocks to prevent generating a trailing empty<span />tag -
#12664
a71e9b9Thanks @bluwy! - Fixes frontmatter parsing if file is encoded in UTF8 with BOM
Patch Changes
- Update
peerDependenciesto support Astro 4.14.0+ and 5.x (c9a0772)
Patch Changes
- Update
peerDependenciesto support Astro 4.14.0+ and 5.x (c9a0772)
Patch Changes
- Handle missing GitHub token error (
0ddb6b5)
Patch Changes
- #12576
19b3ac0Thanks @apatel369! - Fixes an issue where runningupgradein a directory withoutastroinstalled shows a false success message
Minor Changes
- Add
monthsBackoption in 'repoList' mode to specify the recent months for loading releases (752ee0e)
Patch Changes
- Handle missing GitHub token error & Optimize logging (
de1a6cc)
Patch Changes
- #12594
4f2fd0aThanks @Princesseuh! - Fixes compatibility with Astro 5
Patch Changes
- #12594
4f2fd0aThanks @Princesseuh! - Fixes compatibility with Astro 5
Patch Changes
- #12594
4f2fd0aThanks @Princesseuh! - Fixes compatibility with Astro 5
Patch Changes
- #12594
4f2fd0aThanks @Princesseuh! - Fixes compatibility with Astro 5
Patch Changes
- #12594
4f2fd0aThanks @Princesseuh! - Fixes compatibility with Astro 5
Patch Changes
- #12594
4f2fd0aThanks @Princesseuh! - Fixes compatibility with Astro 5
Major Changes
-
#11861
3ab3b4eThanks @bluwy! - Cleans up Astro-specfic metadata attached tovfile.datain Remark and Rehype plugins. Previously, the metadata was attached in different locations with inconsistent names. The metadata is now renamed as below:vfile.data.__astroHeadings->vfile.data.astro.headingsvfile.data.imagePaths->vfile.data.astro.imagePaths
The types of
imagePathshas also been updated fromSet<string>tostring[]. Thevfile.data.astro.frontmattermetadata is left unchanged.While we don't consider these APIs public, they can be accessed by Remark and Rehype plugins that want to re-use Astro's metadata. If you are using these APIs, make sure to access them in the new locations.
-
#12008
5608338Thanks @Princesseuh! - Welcome to the Astro 5 beta! This release has no changes from the latest alpha of this package, but it does bring us one step closer to the final, stable release.Starting from this release, no breaking changes will be introduced unless absolutely necessary.
To learn how to upgrade, check out the Astro v5.0 upgrade guide in our beta docs site.
-
#11825
560ef15Thanks @bluwy! - Updates return object ofcreateShikiHighlighterascodeToHastandcodeToHtmlto allow generating either the hast or html string directly -
#11661
83a2a64Thanks @bluwy! - Renames the following CSS variables theme color token names to better align with the Shiki v1 defaults:--astro-code-color-text=>--astro-code-foreground--astro-code-color-background=>--astro-code-background
You can perform a global find and replace in your project to migrate to the new token names.
-
#11861
3ab3b4eThanks @bluwy! - RemovesInvalidAstroDataError,safelyGetAstroData, andsetVfileFrontmatterAPIs in favour ofisFrontmatterValid
Patch Changes
Minor Changes
-
#12008
5608338Thanks @Princesseuh! - Welcome to the Astro 5 beta! This release has no changes from the latest alpha of this package, but it does bring us one step closer to the final, stable release.Starting from this release, no breaking changes will be introduced unless absolutely necessary.
To learn how to upgrade, check out the Astro v5.0 upgrade guide in our beta docs site.
-
#11989
3e70853Thanks @florian-lefebvre! - Updates the type fromRouteDatatoIntegrationRouteData
Major Changes
-
#12060
cb5d3aeThanks @Princesseuh! - Updates peer dependency range to support Astro 5 -
#12524
9f44019Thanks @bluwy! - Updates Vite dependency to v6 to match Astro v5
Minor Changes
Patch Changes
- #12551
81b0bf5Thanks @ematipico! - New release to include changes from 4.5.2
Major Changes
-
#12060
cb5d3aeThanks @Princesseuh! - Updates peer dependency range to support Astro 5 -
#12524
9f44019Thanks @bluwy! - Updates@sveltejs/vite-plugin-svelteto v5 to handle Vite 6 -
#12524
9f44019Thanks @bluwy! - Updates Vite dependency to v6 to match Astro v5
Minor Changes
Patch Changes
Major Changes
-
#12231
90ae100Thanks @bluwy! - Handles the breaking change in Astro where content pages (including.mdxpages located withinsrc/pages/) no longer respond withcharset=utf-8in theContent-Typeheader.For MDX pages without layouts,
@astrojs/mdxwill automatically add the<meta charset="utf-8">tag to the page by default. This reduces the boilerplate needed to write with non-ASCII characters. If your MDX pages have a layout, the layout component should include the<meta charset="utf-8">tag.If you require
charset=utf-8to render your page correctly, make sure that your layout components have the<meta charset="utf-8">tag added. -
#12008
5608338Thanks @Princesseuh! - Welcome to the Astro 5 beta! This release has no changes from the latest alpha of this package, but it does bring us one step closer to the final, stable release.Starting from this release, no breaking changes will be introduced unless absolutely necessary.
To learn how to upgrade, check out the Astro v5.0 upgrade guide in our beta docs site.
Minor Changes
-
#11741
6617491Thanks @bluwy! - Updates adapter server entrypoint to use@astrojs/mdx/server.jsThis is an internal change. Handling JSX in your
.mdxfiles has been moved from Astro internals and is now the responsibility of this integration. You should not notice a change in your project, and no update to your code is required.
Patch Changes
-
#12075
a19530eThanks @bluwy! - Parses frontmatter ourselves -
#11861
3ab3b4eThanks @bluwy! - Updates@astrojs/markdown-remarkand handle its breaking changes -
#12533
1b61fdfThanks @ematipico! - Fixes a case where the MDX renderer couldn't be loaded when used as a direct dependency of an Astro integration. -
Updated dependencies [
3ab3b4e,5608338,560ef15,83a2a64,3ab3b4e,a19530e]:- @astrojs/markdown-remark@6.0.0
Major Changes
Minor Changes
Minor Changes
Patch Changes
-
#11825
560ef15Thanks @bluwy! - Uses latest version of@astrojs/markdown-remarkwith updated Shiki APIs -
#12075
a19530eThanks @bluwy! - Parses frontmatter ourselves -
#12584
fa07002Thanks @ascorbic! - Correctly renders boolean HTML attributes -
Updated dependencies [
3ab3b4e,5608338,827093e,560ef15,83a2a64,3ab3b4e,a19530e,1dc8f5e]:- @astrojs/markdown-remark@6.0.0
- @astrojs/prism@3.2.0
- @astrojs/internal-helpers@0.4.2
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.
Patch Changes
- Updated dependencies [
827093e]:- @astrojs/prism@3.2.0-beta.0
Major Changes
- Supports loading GitHub pull reuqests from a given GitHub search string (
deb6408)
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.
🚀 Features
- nav: Add
mergeOnMobileoption to merge navigation and social links on mobile - by @lin-stephanie (9e7cd) - search: Full-screen search panel with backdrop for viewport < 1128px - by @lin-stephanie (f8831)
🐞 Bug Fixes
- rss: Resolve MDX post parsing error - by @lin-stephanie (c9ef3)
- style: Ensure responsive alignment for social sections on
/- by @lin-stephanie (4b567)
View changes on GitHub
Last fetched: | Scheduled refresh: Every Saturday
See Customizing GitHub Activity Pages to configure your own
Inspired by releases.antfu.me