Skip to content

feat(v7): stabilize route caching#13977

Merged
ArmandPhilippot merged 33 commits into
v7from
armand/stable-route-caching
Jun 19, 2026
Merged

feat(v7): stabilize route caching#13977
ArmandPhilippot merged 33 commits into
v7from
armand/stable-route-caching

Conversation

@ArmandPhilippot

@ArmandPhilippot ArmandPhilippot commented Jun 2, 2026 •
edited
Loading

Copy link
Copy Markdown
Member

Description (required)

Updates docs to stabilize route caching. Kinda supersedes #13944

  • Cherry-picks changes made in Update v7 upgrade guide changes #13944 to the v7 upgrade guide
  • Moves experimental-flags/route-caching contents to references/cache-provider.mdx (new), references/api-reference.mdx, guides/content-collections.mdx, and guides/caching.mdx (new)
  • Updates the sidebar to remove/add pages
  • Updates references/modules/astro-config to include memoryCache()
  • Adds a redirection

Most of the content comes from experimental-flags/route-caching. But I have tweaked/reworded some parts for better integration (ie. a more guide/reference style).

Why a new guides/caching.mdx page vs a new section in guides/routing.mdx:

  • Route caching as a guide had a lot of content, this seemed a bit unbalanced in guides/routing.mdx
  • Route caching requires on-demand rendering and features requiring an adapter are listed under "Server rendering"

Happy to discuss about the new routes if we think something else might be better!

Related issues & labels (optional)

  • Suggested label: 7.0

For Astro version: 7.0. See astro PR #17116

@ArmandPhilippot ArmandPhilippot added this to the v7 milestone Jun 2, 2026
@netlify

netlify Bot commented Jun 2, 2026 •
edited
Loading

Copy link
Copy Markdown

✅ Deploy Preview for astro-docs-2 ready!

Name Link
🔨 Latest commit 4ac0cf6
🔍 Latest deploy log https://app.netlify.com/projects/astro-docs-2/deploys/6a271f560818400008dddeb2
😎 Deploy Preview https://deploy-preview-13977--astro-docs-2.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@astrobot-houston

astrobot-houston commented Jun 2, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Lunaria Status Overview

🌕 This pull request will trigger status changes.

Learn more

By default, every PR changing files present in the Lunaria configuration's files property will be considered and trigger status changes accordingly.

You can change this by adding one of the keywords present in the ignoreKeywords property in your Lunaria configuration file in the PR's title (ignoring all files) or by including a tracker directive in the merged commit's description.

Tracked Files

File Note
en/guides/caching.mdx Localization added, will be marked as complete.
en/guides/content-collections.mdx Source changed, localizations will be marked as outdated.
en/guides/upgrade-to/v7.mdx Localization changed, will be marked as complete.
en/reference/api-reference.mdx Source changed, localizations will be marked as outdated.
en/reference/cache-provider-reference.mdx Localization added, will be marked as complete.
en/reference/content-loader-reference.mdx Source changed, localizations will be marked as outdated.
en/reference/experimental-flags/route-caching.mdx Localization removed, will be marked as missing.
en/reference/modules/astro-config.mdx Source changed, localizations will be marked as outdated.
en/reference/modules/astro-content.mdx Source changed, localizations will be marked as outdated.
en/reference/modules/astro-fetch.mdx Localization changed, will be marked as complete.
fr/reference/content-loader-reference.mdx Localization changed, will be marked as complete. 🔄️
fr/reference/modules/astro-content.mdx Localization changed, will be marked as complete.
ko/reference/content-loader-reference.mdx Localization changed, will be marked as complete. 🔄️
ko/reference/modules/astro-content.mdx Localization changed, will be marked as complete.
zh-cn/reference/content-loader-reference.mdx Localization changed, will be marked as complete. 🔄️
zh-cn/reference/modules/astro-content.mdx Localization changed, will be marked as complete.
Warnings reference
Icon Description
🔄️ The source for this localization has been updated since the creation of this pull request, make sure all changes in the source have been applied.

@ArmandPhilippot ArmandPhilippot added the merge-on-release Don't merge this before the feature is released! (MQ=approved but WAIT for feature release!) label Jun 2, 2026
@github-actions github-actions Bot added the i18n Anything to do with internationalization & translation efforts - ask @YanThomas for help! label Jun 2, 2026
@ArmandPhilippot ArmandPhilippot marked this pull request as ready for review June 4, 2026 17:26
@ArmandPhilippot ArmandPhilippot mentioned this pull request Jun 4, 2026
Closed
yanthomasdev
yanthomasdev approved these changes Jun 8, 2026
View reviewed changes

@yanthomasdev yanthomasdev left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great work @ArmandPhilippot, I have only one small nit

Comment thread src/content/docs/en/reference/cache-provider-reference.mdx Outdated
@ArmandPhilippot @yanthomasdev
unnecessary comma
4ac0cf6 
Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
@matthewp

matthewp commented Jun 8, 2026

Copy link
Copy Markdown
Contributor

I don't know if route caching is going to make v7, just in case you are spending too much time on this PR. I'll check with Matt to see if he's going to have time to work on it this week.

This was referenced Jun 9, 2026
Merged
Merged
@ascorbic

ascorbic commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

@matthewp I'm looking at it at the moment

ascorbic
ascorbic reviewed Jun 18, 2026
View reviewed changes
Comment thread src/content/docs/en/guides/upgrade-to/v7.mdx Outdated
ascorbic
ascorbic reviewed Jun 18, 2026
View reviewed changes
Comment thread src/content/docs/en/guides/upgrade-to/v7.mdx Outdated
@ascorbic ascorbic mentioned this pull request Jun 18, 2026
Merged
@ascorbic

ascorbic commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

Code PR: withastro/astro#17116

@github-actions

github-actions Bot commented Jun 18, 2026 •
edited
Loading

Copy link
Copy Markdown

Preview deployment

✅ Deployment complete!

@ArmandPhilippot

ArmandPhilippot commented Jun 18, 2026

Copy link
Copy Markdown
Member Author

Thanks Matt, nice catch. 😅 Updated in 497f375. I also fixed the merge conflicts!

yanthomasdev
yanthomasdev reviewed Jun 19, 2026
View reviewed changes
Comment thread src/content/docs/en/guides/caching.mdx Outdated
@ArmandPhilippot @yanthomasdev
just in time, thanks Yan!
f217bff 
Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com>
@ArmandPhilippot ArmandPhilippot merged commit 516196e into v7 Jun 19, 2026
9 checks passed
@ArmandPhilippot ArmandPhilippot deleted the armand/stable-route-caching branch June 19, 2026 16:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@ascorbic ascorbic ascorbic left review comments
@yanthomasdev yanthomasdev yanthomasdev approved these changes

Assignees

No one assigned

Labels

7.0 i18n Anything to do with internationalization & translation efforts - ask @YanThomas for help! merge-on-release Don't merge this before the feature is released! (MQ=approved but WAIT for feature release!)

Projects

None yet

Milestone

v7

Development

Successfully merging this pull request may close these issues.

5 participants

@ArmandPhilippot @astrobot-houston @matthewp @ascorbic @yanthomasdev