Skip to content

feat(v7): stabilize route caching#13977

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

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

Conversation

@ArmandPhilippot
Copy link
Copy Markdown
Member

@ArmandPhilippot ArmandPhilippot commented Jun 2, 2026

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
Copy link
Copy Markdown

netlify Bot commented Jun 2, 2026

Deploy Preview for astro-docs-2 ready!

Name Link
🔨 Latest commit d6e3cd0
🔍 Latest deploy log https://app.netlify.com/projects/astro-docs-2/deploys/6a21b646ee22170008fa2121
😎 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
Copy link
Copy Markdown
Contributor

astrobot-houston commented Jun 2, 2026

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

3 participants