Skip to content

docs: Add Cloud CDN and caching concept page#694

Open
developerjamiu wants to merge 2 commits into
mainfrom
cloud-cdn-page
Open

docs: Add Cloud CDN and caching concept page#694
developerjamiu wants to merge 2 commits into
mainfrom
cloud-cdn-page

Conversation

@developerjamiu

@developerjamiu developerjamiu commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

Adds a new Cloud concept page, Content delivery and caching (cloud_docs/concepts/cdn.md), documenting the recently launched CDN feature.

The page covers:

  • How caching works: the three cache layers (browser, CDN edge, server) and what the common Cache-Control patterns do at each.
  • Enabling caching via cacheControlFactory, with the recommended public, max-age=60, s-maxage=86400 header.
  • Verifying caching with the age response header (GET, not HEAD).
  • Cost and limits: no separate charge, nothing to turn on, per-app isolation, custom domains covered.

Technical claims were checked against the framework source at current main, the cloud repo (E2E deploy test, CLI command surface), and a live cache-opted-in deployment. A few platform facts would benefit from cloud-team confirmation on review:

  • Responses that set a cookie are never cached.
  • HEAD requests are never cached.
  • No usage limits and no separate charge.
  • The deploy purge covers custom domains, and a purge failure never fails the deploy (freshness falls back to the CDN lifetime).
  • The cleared cache refills per edge location.

Planned follow-ups in separate PRs: correct the default-caching claims on the framework Flutter web page (they predate the current uniform no-cache, private default), and add a one-line note to the Deployments page that a successful deploy clears the CDN cache.

@developerjamiu
developerjamiu requested a review from Zfinix July 21, 2026 12:32
@developerjamiu developerjamiu added the documentation Improvements or additions to documentation label Jul 21, 2026

@Zfinix Zfinix left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

LGTM 🚀

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

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants