Correct Astro.url root pathname for file format builds by matthewp · Pull Request #15882 · withastro/astro

matthewp · 2026-03-12T15:51:12Z

Changes

fix root Astro.url.pathname in build.format: \"file\" builds to return /index.html instead of /.html

Testing

add integration assertions for root and non-root Astro.url.pathname behavior in page-format tests

Docs

N/A, bug fix

Closes #15866

changeset-bot · 2026-03-12T15:51:21Z

🦋 Changeset detected

Latest commit: c0627e5

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

codspeed-hq · 2026-03-12T16:08:36Z

Merging this PR will not alter performance

✅ 18 untouched benchmarks

_{Comparing astro-url-html (c0627e5) with main (f47ac53)¹}

No successful run was found on main (b16ee32) during the generation of this report, so f47ac53 was used instead as the comparison base. There might be some changes unrelated to this pull request in this report. ↩

delucis

As this is a change in behaviour from v5, we should add a migration guide entry I guess? In v5, Astro.url.pathname was / in both dev and build.

(I’d also like to understand the motivation for the change in behaviour if possible — in general we aim to avoid dev/build differences as it makes it trickier for users to write code that handles both.)

matthewp · 2026-03-12T16:49:00Z

@delucis The documented behavior is that it includes .html: https://docs.astro.build/en/reference/configuration-reference/#effect-on-astrourl

I don't think these docs were added for v6 were they?

delucis · 2026-03-12T19:39:24Z

I don't think these docs were added for v6 were they?

Oh you’re right, these docs were also in v5:
https://v5.docs.astro.build/en/reference/configuration-reference/#effect-on-astrourl

So I guess we’re considering the v5 behaviour a bug, so not documenting the change? (I still find it weird that there’s a dev/build difference, but if it’s what we documented then that’s a conversation for another time.)

matthewp · 2026-03-13T11:58:07Z

@delucis Yeah if I could do it over I would not include build.format as part of the Astro.url at all. It's a build configuration that says how to output files, it's not a configuration for how Astro treats URL, like trailingSlash is. Let's talk about changing this behavior in Astro 7.

This PR contains the following updates: | Package | Change | [Age](https://docs.renovatebot.com/merge-confidence/) | [Confidence](https://docs.renovatebot.com/merge-confidence/) | |---|---|---|---| | [@astrojs/check](https://github.com/withastro/astro/tree/main/packages/language-tools/astro-check) ([source](https://github.com/withastro/astro/tree/HEAD/packages/language-tools/astro-check)) | [`0.9.7` → `0.9.8`](https://renovatebot.com/diffs/npm/@astrojs%2fcheck/0.9.7/0.9.8) | ![age](https://developer.mend.io/api/mc/badges/age/npm/@astrojs%2fcheck/0.9.8?slim=true) | ![confidence](https://developer.mend.io/api/mc/badges/confidence/npm/@astrojs%2fcheck/0.9.7/0.9.8?slim=true) | | [astro](https://astro.build) ([source](https://github.com/withastro/astro/tree/HEAD/packages/astro)) | [`6.0.4` → `6.0.5`](https://renovatebot.com/diffs/npm/astro/6.0.4/6.0.5) | ![age](https://developer.mend.io/api/mc/badges/age/npm/astro/6.0.5?slim=true) | ![confidence](https://developer.mend.io/api/mc/badges/confidence/npm/astro/6.0.4/6.0.5?slim=true) | --- ### Release Notes <details> <summary>withastro/astro (@astrojs/check)</summary> ### [`v0.9.8`](https://github.com/withastro/astro/blob/HEAD/packages/language-tools/astro-check/CHANGELOG.md#098) [Compare Source](https://github.com/withastro/astro/compare/@astrojs/check@0.9.7...@astrojs/check@0.9.8) ##### Patch Changes - [#15892](withastro/astro#15892) [`a2f597d`](withastro/astro@a2f597d) Thanks [@Princesseuh](https://github.com/Princesseuh)! - Fixes Astro not being able to find astro check sometimes - Updated dependencies \[[`7b4b254`](withastro/astro@7b4b254)]: - [@astrojs/language-server](https://github.com/astrojs/language-server)@2.16.5 </details> <details> <summary>withastro/astro (astro)</summary> ### [`v6.0.5`](https://github.com/withastro/astro/blob/HEAD/packages/astro/CHANGELOG.md#605) [Compare Source](https://github.com/withastro/astro/compare/astro@6.0.4...astro@6.0.5) ##### Patch Changes - [#15891](withastro/astro#15891) [`b889231`](withastro/astro@b889231) Thanks [@matthewp](https://github.com/matthewp)! - Fix dev routing for `server:defer` islands when adapters opt into handling prerendered routes in Astro core. Server island requests are now treated as prerender-handler eligible so prerendered pages using `prerenderEnvironment: 'node'` can load island content without `400` errors. - [#15890](withastro/astro#15890) [`765a887`](withastro/astro@765a887) Thanks [@matthewp](https://github.com/matthewp)! - Fixes `astro:actions` validation to check resolved routes, so projects using default static output with at least one `prerender = false` page or endpoint no longer fail during startup. - [#15884](withastro/astro#15884) [`dcd2c8e`](withastro/astro@dcd2c8e) Thanks [@matthewp](https://github.com/matthewp)! - Avoid a `MaxListenersExceededWarning` during `astro dev` startup by increasing the shared Vite watcher listener limit when attaching content server listeners. - [#15904](withastro/astro#15904) [`23d5244`](withastro/astro@23d5244) Thanks [@jlukic](https://github.com/jlukic)! - Emit the `before-hydration` script chunk for the `client` Vite environment. The chunk was only emitted for `prerender` and `ssr` environments, causing a 404 when browsers tried to load it. This broke hydration for any integration using `injectScript('before-hydration', ...)`, including Lit SSR. - [#15933](withastro/astro#15933) [`325901e`](withastro/astro@325901e) Thanks [@ematipico](https://github.com/ematipico)! - Fixes an issue where `<style>` tags inside SVG components weren't correctly tracked when enabling CSP. - [#15875](withastro/astro#15875) [`c43ef8a`](withastro/astro@c43ef8a) Thanks [@matthewp](https://github.com/matthewp)! - Ensure custom prerenderers are always torn down during build, even when `getStaticPaths()` throws. - [#15887](withastro/astro#15887) [`1861fed`](withastro/astro@1861fed) Thanks [@ematipico](https://github.com/ematipico)! - Fixes an issue where the build incorrectly leaked server entrypoint into the client environment, causing adapters to emit warnings during the build. - [#15888](withastro/astro#15888) [`925252e`](withastro/astro@925252e) Thanks [@matthewp](https://github.com/matthewp)! - Fix a bug where `server:defer` could fail at runtime in prerendered pages for some adapters (including Cloudflare), causing errors like `serverIslandMap?.get is not a function`. - [#15901](withastro/astro#15901) [`07c1002`](withastro/astro@07c1002) Thanks [@delucis](https://github.com/delucis)! - Fixes JSON schema generation for content collection schemas that have differences between their input and output shapes. - [#15882](withastro/astro#15882) [`759f946`](withastro/astro@759f946) Thanks [@matthewp](https://github.com/matthewp)! - Fix `Astro.url.pathname` for the root page when using `build.format: "file"` so it resolves to `/index.html` instead of `/.html` during builds. </details> --- ### Configuration 📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined). 🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied. ♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox. 👻 **Immortal**: This PR will be recreated if closed unmerged. Get [config help](https://github.com/renovatebot/renovate/discussions) if that's undesired. --- - [ ] If you want to rebase/retry this PR, check this box --- This PR has been generated by [Renovate Bot](https://github.com/renovatebot/renovate).  Co-authored-by: Renovate Bot <renovate@zarantonello.dev> Co-committed-by: Renovate Bot <renovate@zarantonello.dev>

fix(astro): fix root Astro.url pathname for file format

c0627e5

matthewp changed the title ~~fix(astro): correct Astro.url root pathname for file format builds~~ Correct Astro.url root pathname for file format builds Mar 12, 2026

github-actions bot added the pkg: astro Related to the core `astro` package (scope) label Mar 12, 2026

matthewp marked this pull request as ready for review March 12, 2026 16:21

delucis reviewed Mar 12, 2026

View reviewed changes

Princesseuh approved these changes Mar 12, 2026

View reviewed changes

ematipico approved these changes Mar 13, 2026

View reviewed changes

delucis approved these changes Mar 13, 2026

View reviewed changes

matthewp merged commit 759f946 into main Mar 13, 2026
26 checks passed

matthewp deleted the astro-url-html branch March 13, 2026 15:15

astrobot-houston mentioned this pull request Mar 13, 2026

[ci] release #15889

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Correct Astro.url root pathname for file format builds#15882

Correct Astro.url root pathname for file format builds#15882
matthewp merged 1 commit intomainfrom
astro-url-html

matthewp commented Mar 12, 2026 •

edited

Loading

Uh oh!

changeset-bot bot commented Mar 12, 2026

Uh oh!

codspeed-hq bot commented Mar 12, 2026

Uh oh!

delucis left a comment •

edited

Loading

Uh oh!

matthewp commented Mar 12, 2026

Uh oh!

delucis commented Mar 12, 2026

Uh oh!

matthewp commented Mar 13, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Uh oh!

Conversation

matthewp commented Mar 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changes

Testing

Docs

Uh oh!

changeset-bot bot commented Mar 12, 2026

🦋 Changeset detected

Uh oh!

codspeed-hq bot commented Mar 12, 2026

Merging this PR will not alter performance

Footnotes

Uh oh!

delucis left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

matthewp commented Mar 12, 2026

Uh oh!

delucis commented Mar 12, 2026

Uh oh!

matthewp commented Mar 13, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

matthewp commented Mar 12, 2026 •

edited

Loading

delucis left a comment •

edited

Loading