Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
112 commits
Select commit Hold shift + click to select a range
099c3a0
create v6 upgrade guide page
sarah11918 Sep 15, 2025
64ea345
add sections
sarah11918 Sep 19, 2025
1a1f081
Remove ViewTransitions in v6 (#12347)
ellielok Sep 19, 2025
3e61972
updates home page banner to point to v6
sarah11918 Sep 22, 2025
b0aec7b
[v6] remove emitESMImage() (#12403)
florian-lefebvre Sep 23, 2025
49cfc17
[v6] redirectToDefaultLocale default behaviour change (#12353)
florian-lefebvre Sep 25, 2025
f7e6625
[v6]: remove Astro.glob() [i18nIgnore] (#12401)
florian-lefebvre Sep 25, 2025
35cc592
[v6] drop node 18 (#12423)
florian-lefebvre Sep 25, 2025
8292fb3
feat: update version
florian-lefebvre Sep 25, 2025
2b258ce
[v6] update vite to v7 (#12444)
florian-lefebvre Sep 29, 2025
369c7ab
[v6] deprecate Astro in getStaticPaths (#12435)
florian-lefebvre Sep 29, 2025
824ae0d
[v6] integration api cleanup (#12445)
florian-lefebvre Sep 29, 2025
43e9116
[v6] deprecate import.meta.env.ASSETS_PREFIX (#12468)
florian-lefebvre Oct 1, 2025
e840333
[v6] clean deprecated APIs (#12469)
florian-lefebvre Oct 1, 2025
7586143
[v6] trailing slash never for endpoints with file extension (#12467)
florian-lefebvre Oct 1, 2025
844769b
fix: diff
florian-lefebvre Oct 2, 2025
e397c23
fix: typo
florian-lefebvre Oct 2, 2025
31685a2
[v6] stabilize experimental.preserveScriptOrder option (#12480)
florian-lefebvre Oct 3, 2025
e3e6ab4
[v6] stabilize experimental.staticImportMetaEnv (#12494)
florian-lefebvre Oct 3, 2025
7306a26
[v6] remove context.rewrite in actions (#12477)
florian-lefebvre Oct 3, 2025
50394ca
i18n(ja): update `guides/imports.mdx` (#12449)
tkskto Oct 5, 2025
7962307
i18n(ja): update `tutorial/5-astro-api/1.mdx` (#12452)
tkskto Oct 5, 2025
b7d1636
[v6] stabilize experimental.headingIdCompat (#12510)
florian-lefebvre Oct 15, 2025
a409a05
simplify experimental flags section (#12587)
sarah11918 Oct 20, 2025
ab8cf68
support for legacy content collections removed (#12376)
sarah11918 Oct 20, 2025
40e4e34
Merge branch 'main' into v6
sarah11918 Oct 23, 2025
88ef3c5
[i18nIgnore] Localized v6 link failures related to Astro.glob() (#12616)
sarah11918 Oct 24, 2025
19a4fbe
Merge branch 'main' into v6
sarah11918 Oct 24, 2025
5d03bde
[v6] disallow number in getStaticPaths params (#12608)
ocavue Oct 27, 2025
7bee4c3
feat(reference): Update astro:assets reference for new Astro 6.0 beha…
Princesseuh Nov 7, 2025
251099c
Merge branch 'main' into v6
sarah11918 Nov 7, 2025
c60a6bf
some bold for emphasizing no more content collections backwards compa…
sarah11918 Nov 10, 2025
df25155
[next] remove app.setManifestData() (#12701)
florian-lefebvre Nov 12, 2025
25d8e57
Merge branch 'main' into v6
sarah11918 Nov 12, 2025
d1763cf
[next]: stabilize failOnPrerenderConflict (#12745)
florian-lefebvre Nov 21, 2025
8d5a0a9
Merge branch 'main' into v6
sarah11918 Nov 21, 2025
8f91a3a
updates link for deprecated `integrationRouteData`
sarah11918 Nov 24, 2025
9d74ea2
Merge branch 'main' into v6
sarah11918 Nov 24, 2025
e863a5e
Merge branch 'main' into v6
delucis Nov 27, 2025
8761f6d
[next]: add migration section for removal of internal exports (#12816)
trueberryless Dec 2, 2025
e3f2582
[v6] New content collections guide includes live collections (#12604)
sarah11918 Dec 3, 2025
d2e0318
Remove experimental live collections page (#12826)
sarah11918 Dec 3, 2025
fb02228
[next]: astro/zod (#12815)
florian-lefebvre Dec 3, 2025
4320520
fix code syntax
sarah11918 Dec 3, 2025
4859404
[next]: content loaders breaking changes (#12824)
florian-lefebvre Dec 4, 2025
9dce489
Merge branch 'main' into v6
sarah11918 Dec 4, 2025
d156b0d
Address v6 link errors (#12836)
sarah11918 Dec 4, 2025
b82df7e
Merge branch 'main' into v6
sarah11918 Dec 4, 2025
61a69c9
feat: show v6 migration guide in sidebar (#12833)
trueberryless Dec 4, 2025
09df252
docs: document Environment API breaking changes (#12809)
matthewp Dec 4, 2025
75aa7ec
Merge branch 'main' into v6
ArmandPhilippot Dec 9, 2025
2b40341
fix a remaining merge conflict...
ArmandPhilippot Dec 9, 2025
e4a63de
there was another merge conflict...
ArmandPhilippot Dec 9, 2025
c80bf3e
[next]: deprecate transitions exports (#12861)
florian-lefebvre Dec 10, 2025
cab31de
[v6] Update `astro/zod` docs for Zod 4 + code snippets in other pages…
ArmandPhilippot Dec 10, 2025
d3883e7
[REVERT ME] Explicitly include header to enforce no indexing of this …
delucis Dec 11, 2025
6a4f86a
Merge branch 'main' into v6
ArmandPhilippot Dec 11, 2025
abb5525
delete `/ko/` CSP experimental guide to resolve conflicts
sarah11918 Dec 12, 2025
d956ec1
Add section on Zod 4 to v6 migration guide (#12848)
matthewp Dec 12, 2025
c94b19b
feat: stabilize CSP (#12859)
ematipico Dec 12, 2025
a0ea02b
[next]: i18n middleware change (#12797)
florian-lefebvre Dec 12, 2025
744a860
docs(ja): add security.csp reference
jp-knj Dec 13, 2025
1649202
chore: remove csp slug
jp-knj Dec 13, 2025
518b05b
Merge branch 'main' into v6
ArmandPhilippot Dec 13, 2025
795498f
Fix HTML output example in upgrade guide (#12904)
hfournier Dec 15, 2025
14359ba
Merge branch 'main' into v6
ArmandPhilippot Dec 15, 2025
c523fc6
fix chinese link related to csp
ArmandPhilippot Dec 15, 2025
da6e544
move bold text + remove extra ** in v6 migration page (#12903)
KTrain5169 Dec 15, 2025
d1ae295
Use `alpha` tag in upgrade command (#12913)
HiDeoo Dec 15, 2025
af2b495
Add Zod v3 → v4 codemod link to upgrade guide (#12905)
HiDeoo Dec 15, 2025
0987548
[v6]: add docs for `entryType` in Adapter API (#12915)
ArmandPhilippot Dec 15, 2025
196da7d
[BETA] ci: update error reference docs (#12918)
astrobot-houston Dec 15, 2025
af70a5a
change resource sentence to say v6 instead of v5 in v6 migration guid…
KTrain5169 Dec 16, 2025
28b1beb
[v6 upgrade guide] Add section for adapter major upgrade guidance (#1…
sarah11918 Dec 16, 2025
63d1c5f
fix(next): typo "v5" in v6 migration guide (#12931)
trueberryless Dec 16, 2025
324ba5c
Merge branch 'main' into v6
sarah11918 Dec 16, 2025
1075a2e
Merge branch 'main' into v6
ArmandPhilippot Dec 16, 2025
6d62faa
fix link in upgrade guide
ArmandPhilippot Dec 16, 2025
9f21c9a
[BETA] ci: update reference docs (#12917)
astrobot-houston Dec 16, 2025
9dc2a10
Merge branch 'main' into v6
ArmandPhilippot Dec 18, 2025
27adf43
[next]: session drivers (#12951)
florian-lefebvre Dec 18, 2025
fd0dfd2
[BETA] ci: update reference docs (#12953)
astrobot-houston Dec 18, 2025
c897c87
docs: document Vitest SSR environment requirement for Astro 6 (#12808)
Ntale3 Dec 19, 2025
f681e79
Add Vitest minimum version note for Astro v6.0 (#12961)
HiDeoo Dec 19, 2025
b5e1670
Merge branch 'main' into v6
ArmandPhilippot Dec 19, 2025
e0dd336
Merge branch 'main' into v6
sarah11918 Dec 19, 2025
98f6dbf
fix a content collections anchor link coming from v5 main docs
sarah11918 Dec 19, 2025
b294499
add legacy.collectionsBackwardsCompat flag docs for v6 (#13022)
matthewp Jan 12, 2026
8945708
Merge branch 'main' into v6
sarah11918 Jan 12, 2026
9b41ad0
fix two broken links (unmaintained v5, blog post)
ArmandPhilippot Jan 12, 2026
c2c3df9
replace one remaining `astro:schema` with `astro/zod`
ArmandPhilippot Jan 12, 2026
be8a734
docs: update `getViteConfig()` vitest requirements
HiDeoo Jan 12, 2026
eb197e4
Update install commit in v6 guide to beta (#13038)
matthewp Jan 13, 2026
4319476
[next]: drop cjs config
florian-lefebvre Jan 14, 2026
c02ddb5
Add Cloudflare Astro 6 docs (#12981)
ascorbic Jan 14, 2026
ae766ad
Merge branch 'main' into v6
ArmandPhilippot Jan 16, 2026
7e73931
Merge branch 'main' into v6
ArmandPhilippot Jan 16, 2026
3c911e1
Merge branch 'main' into v6
ArmandPhilippot Jan 21, 2026
5390b2c
fix links related to integrations reference and translations
ArmandPhilippot Jan 21, 2026
d81b5d2
astro build environments (#12872)
ematipico Jan 21, 2026
3fc17c7
[next]: make runtime csp optional (#13079)
florian-lefebvre Jan 21, 2026
d7ca642
[BETA] ci: update error reference docs (#13090)
astrobot-houston Jan 22, 2026
209e807
Merge branch 'main' into v6
florian-lefebvre Jan 23, 2026
6a47f92
[BETA] ci: update error reference docs (#13103)
astrobot-houston Jan 23, 2026
98c833d
feat(v6): file parser can async
Princesseuh Jan 23, 2026
e5e290b
nit: missing dot
Princesseuh Jan 23, 2026
5ae7489
reference for withastro/astro#15153
jcayzac Jan 25, 2026
373da77
update release version and light text edit
sarah11918 Jan 26, 2026
d16b655
fix(content-reference): Update types for new async signature
Princesseuh Jan 26, 2026
5bfba06
fix(v6): use consistent headings level in `astro:assets` (#13146)
ArmandPhilippot Jan 26, 2026
1970cf7
Merge branch 'v6' into feat/img-background
sarah11918 Jan 26, 2026
be46282
Merge branch 'main' into feat/img-background
sarah11918 Jan 26, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 2 additions & 7 deletions astro.sidebar.ts
Original file line number Diff line number Diff line change
Expand Up @@ -90,6 +90,7 @@ export const sidebar = [
group('guides.upgrade.major', {
collapsed: true,
items: [
'guides/upgrade-to/v6',
'guides/upgrade-to/v5',
'guides/upgrade-to/v4',
'guides/upgrade-to/v3',
Expand Down Expand Up @@ -136,24 +137,18 @@ export const sidebar = [
'reference/content-loader-reference',
'reference/image-service-reference',
'reference/dev-toolbar-app-reference',
'reference/session-driver-reference',
'reference/container-reference',
'reference/programmatic-reference',
],
}),
group('reference.experimental', {
items: [
'reference/experimental-flags',
'reference/experimental-flags/csp',
'reference/experimental-flags/fonts',
'reference/experimental-flags/live-content-collections',
'reference/experimental-flags/client-prerender',
'reference/experimental-flags/content-intellisense',
'reference/experimental-flags/preserve-scripts-order',
'reference/experimental-flags/heading-id-compat',
'reference/experimental-flags/static-import-meta-env',
'reference/experimental-flags/chrome-devtools-workspace',
'reference/experimental-flags/fail-on-prerender-conflict',
'reference/experimental-flags/svg-optimization',
],
}),
'reference/legacy-flags',
Expand Down
4 changes: 4 additions & 0 deletions public/_headers
Original file line number Diff line number Diff line change
Expand Up @@ -2,3 +2,7 @@
cache-control: max-age=31536000
cache-control: immutable
cache-control: public

# TODO: Remove this before merging to main
/*
x-robots-tag: no-index
2 changes: 1 addition & 1 deletion src/content/docs/de/basics/project-structure.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -125,7 +125,7 @@ Eine Anleitung zur Erstellung einer neuen `package.json`-Datei für dein Projekt

Diese Datei wird von jeder Starter-Vorlage generiert und enthält Konfigurations­optionen für dein Astro-Projekt. Hier kannst du die zu verwendenden Integrationen, Build-Optionen, Serveroptionen und mehr angeben.

Astro unterstützt mehrere Dateiformate für seine JavaScript-Konfigurationsdatei: `astro.config.js`, `astro.config.mjs`, `astro.config.cjs` und `astro.config.ts`. Wir empfehlen, in den meisten Fällen `.mjs` oder `.ts` zu verwenden, wenn du TypeScript in deiner Konfigurationsdatei schreiben willst.
Astro unterstützt mehrere Dateiformate für seine JavaScript-Konfigurationsdatei: `astro.config.js`, `astro.config.mjs` und `astro.config.ts`. Wir empfehlen, in den meisten Fällen `.mjs` oder `.ts` zu verwenden, wenn du TypeScript in deiner Konfigurationsdatei schreiben willst.

Das Laden von TypeScript-Konfigurationsdateien wird mit [`tsm`](https://github.com/lukeed/tsm) gehandhabt und berücksichtigt die `tsconfig`-Optionen deines Projekts.

Expand Down
3 changes: 1 addition & 2 deletions src/content/docs/de/tutorial/6-islands/4.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -120,7 +120,6 @@ Aktualisiere Astro und alle Integrationen auf die neuesten Versionen, indem du i
```ts title="src/content.config.ts"
import { glob } from "astro/loaders";
import { defineCollection } from "astro:content";
// Importiere Zod
import { z } from "astro/zod";

const blog = defineCollection({
Expand Down Expand Up @@ -150,7 +149,7 @@ Aktualisiere Astro und alle Integrationen auf die neuesten Versionen, indem du i
1. Erstelle eine neue Seiten­datei `src/pages/posts/[...slug].astro`.
Markdown- und MDX-Dateien werden innerhalb einer Sammlung nicht mehr automatisch zu Seiten. Du musst daher eine Seite erstellen, die für die Ausgabe jedes einzelnen Blogbeitrags verantwortlich ist.

2. Füge den folgenden Code ein, um deine Sammlung [abzufragen](/de/guides/content-collections/#querying-collections) und für jede generierte Seite die `slug` und den Seiteninhalt bereitzustellen:
2. Füge den folgenden Code ein, um deine Sammlung [abzufragen](/de/guides/content-collections/#querying-build-time-collections) und für jede generierte Seite die `slug` und den Seiteninhalt bereitzustellen:

```astro title="src/pages/posts/[...slug].astro"
---
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/en/basics/project-structure.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -124,7 +124,7 @@ For help creating a new `package.json` file for your project, check out the [man

This file is generated in every starter template and includes configuration options for your Astro project. Here you can specify integrations to use, build options, server options, and more.

Astro supports several file formats for its JavaScript configuration file: `astro.config.js`, `astro.config.mjs`, `astro.config.cjs` and `astro.config.ts`. We recommend using `.mjs` in most cases or `.ts` if you want to write TypeScript in your config file.
Astro supports several file formats for its JavaScript configuration file: `astro.config.js`, `astro.config.mjs` and `astro.config.ts`. We recommend using `.mjs` in most cases or `.ts` if you want to write TypeScript in your config file.

TypeScript config file loading is handled using [`tsm`](https://github.com/lukeed/tsm) and will respect your project's `tsconfig` options.

Expand Down
3 changes: 3 additions & 0 deletions src/content/docs/en/getting-started.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,9 @@ i18nReady: true
tableOfContents: false
editUrl: false
next: false
banner:
content: |
Astro v6 is here! <a href="/en/guides/upgrade-to/v6/">Learn how to upgrade your site</a>
hero:
title: Astro Docs
tagline: Guides, resources, and API references to help you build with Astro.
Expand Down
8 changes: 4 additions & 4 deletions src/content/docs/en/guides/actions.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -329,14 +329,14 @@ export const server = {
// Matches when the `type` field has the value `create`
type: z.literal('create'),
name: z.string(),
email: z.string().email(),
email: z.email(),
}),
z.object({
// Matches when the `type` field has the value `update`
type: z.literal('update'),
id: z.number(),
name: z.string(),
email: z.string().email(),
email: z.email(),
}),
]),
async handler(input) {
Expand Down Expand Up @@ -374,7 +374,7 @@ The following example shows a validated newsletter registration form that accept
</form>
```

2. Define a `newsletter` action to handle the submitted form. Validate the `email` field using the `z.string().email()` validator, and the `terms` checkbox using `z.boolean()`:
2. Define a `newsletter` action to handle the submitted form. Validate the `email` field using the `z.email()` validator, and the `terms` checkbox using `z.boolean()`:

```ts title="src/actions/index.ts" ins={5-12}
import { defineAction } from 'astro:actions';
Expand All @@ -384,7 +384,7 @@ The following example shows a validated newsletter registration form that accept
newsletter: defineAction({
accept: 'form',
input: z.object({
email: z.string().email(),
email: z.email(),
terms: z.boolean(),
}),
handler: async ({ email, terms }) => { /* ... */ },
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/en/guides/cms/cloudcannon.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -141,7 +141,7 @@ The following example will create a new blog post from the CloudCannon Site Dash

## Rendering CloudCannon content

Use Astro's Content Collections API to [query and display your posts and collections](/en/guides/content-collections/#querying-collections), just as you would in any Astro project.
Use Astro's Content Collections API to [query and display your posts and collections](/en/guides/content-collections/#querying-build-time-collections), just as you would in any Astro project.

### Displaying a collection list

Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/en/guides/cms/keystatic.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -183,7 +183,7 @@ Visit `http://127.0.0.1:4321/keystatic` in the browser to see the Keystatic Admi

## Rendering Keystatic content

Use Astro's Content Collections API to [query and display your posts and collections](/en/guides/content-collections/#querying-collections), just as you would in any Astro project.
[Query and display your posts and collections](/en/guides/content-collections/#querying-build-time-collections), just as you would in any Astro project.

### Displaying a collection list

Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/en/guides/configuring-astro.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ export default defineConfig({

It is only required if you have something to configure, but most projects will use this file. The `defineConfig()` helper provides automatic IntelliSense in your IDE and is where you will add all your configuration options to tell Astro how to build and render your project to HTML.

We recommend using the default file format `.mjs` in most cases, or `.ts` if you want to write TypeScript in your config file. However, `astro.config.js` and `astro.config.cjs` are also supported.
We recommend using the default file format `.mjs` in most cases, or `.ts` if you want to write TypeScript in your config file. However, `astro.config.js` is also supported.

<ReadMore>Read Astro's [configuration reference](/en/reference/configuration-reference/) for a full overview of all supported configuration options.</ReadMore>

Expand Down
Loading
Loading