Skip to content

feat(v7): stabilize route caching#13977

Open
ArmandPhilippot wants to merge 25 commits into
v7from
armand/stable-route-caching
Open

feat(v7): stabilize route caching#13977
ArmandPhilippot wants to merge 25 commits into
v7from
armand/stable-route-caching

Conversation

@ArmandPhilippot

@ArmandPhilippot ArmandPhilippot commented Jun 2, 2026

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!

It seems there is no associated PR yet for route caching stabilization and this is still experimental on next (https://github.com/withastro/astro/blob/6a90f94acd451dfe6d9f3bcec764c20e6fe2808e/packages/astro/src/types/public/config.ts#L2973-L3050) so we'll need to wait before merging this to v7 docs.

Related issues & labels (optional)

  • Suggested label: 7.0

For Astro version: 7.0. See astro PR ....

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

netlify Bot commented Jun 2, 2026

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

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/advanced-routing.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.
fr/reference/content-loader-reference.mdx Localization changed, will be marked as complete. 🔄️
fr/reference/experimental-flags/advanced-routing.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/experimental-flags/advanced-routing.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

@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
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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

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

Development

Successfully merging this pull request may close these issues.

4 participants