Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Dec 16, 2025

Documentation Update Plan for PR #4454

Based on the changes in serverpod/serverpod#4454, the following updates need to be made to the Flutter web documentation:

  • Review current documentation in /docs/06-concepts/18-webserver/09-flutter-web.md
  • Add section explaining the default cache control behavior for critical Flutter files
  • Document which files get no-cache headers (index.html, flutter_service_worker.js, flutter_bootstrap.js, manifest.json, version.json)
  • Document that other files get public, max-age=86400 (1 day) cache headers by default
  • Update cache control examples to reflect the new default behavior
  • Add explanation that the default behavior is overridable via cacheControlFactory
  • Add instructions for invalidating cached assets by bumping Flutter version
  • Fix warning to clarify that custom cache control doesn't apply to fallback index.html
  • Run markdown linter and fix any issues
  • Verify changes are minimal and accurate
Original prompt

Given the changes in this PR: @serverpod/serverpod/pull/4454

Could you update the documentation for the flutter route to cover these changes.


💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

Co-authored-by: SandPod <137198655+SandPod@users.noreply.github.com>
Copilot AI changed the title [WIP] Update documentation for flutter route changes Document FlutterRoute default cache control behavior Dec 16, 2025
Copilot AI requested a review from SandPod December 16, 2025 19:47
@SandPod
Copy link
Contributor

SandPod commented Dec 16, 2025

@copilot Please add instructions that you should bump the flutter version in order to invalide the cached flutter app.

Co-authored-by: SandPod <137198655+SandPod@users.noreply.github.com>
Copy link
Contributor Author

Copilot AI commented Dec 16, 2025

@copilot Please add instructions that you should bump the flutter version in order to invalide the cached flutter app.

Added instructions for invalidating cached Flutter assets by bumping the version in pubspec.yaml and rebuilding the app (commit ffbf8e6).

Co-authored-by: SandPod <137198655+SandPod@users.noreply.github.com>
Copilot AI requested a review from SandPod December 16, 2025 20:23
@SandPod SandPod marked this pull request as ready for review December 16, 2025 21:21
@SandPod SandPod changed the title Document FlutterRoute default cache control behavior fix: Document FlutterRoute default cache control behavior Dec 16, 2025
@SandPod SandPod requested a review from a team December 16, 2025 21:21
@SandPod SandPod merged commit cea32b0 into main Dec 16, 2025
4 of 5 checks passed
@SandPod SandPod deleted the copilot/update-flutter-route-docs branch December 16, 2025 21:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants