Conversation
Document migration steps through 10.0.0-alpha.5, including platform requirements, API removals, and telemetry behavior changes. Co-Authored-By: Codex <noreply@openai.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
1 Skipped Deployment
|
1 of 6 tasks
buenaflor
changed the title
buenaflor
changed the title
buenaflor
marked this pull request as ready for review
September 24, 2026 09:17
Contributor
There was a problem hiding this comment.
Copilot review overview
🟡 Changes recommended
Unresolved documentation and SDK behavior inconsistencies could mislead Flutter v10 users.
Get a fresh assessment by requesting another Copilot review.
Review effort: Lite
Findings: 1
Open (1)
What changed in this PR
Adds Flutter v9-to-v10 migration documentation, an interactive checklist, agent prompt, and collection-specific progress support.
Changes:
- Adds 17 validated Flutter migration steps and shared guide content.
- Extends migration components and validation for multiple collections.
- Adds full and interactive migration guides with scoped progress storage.
| File | Summary |
|---|---|
src/components/migrationGuide/index.tsx |
Supports multiple migration collections and storage scopes. |
src/components/migrationGuide/index.spec.tsx |
Tests collection behavior and progress isolation. |
src/components/migrationGuide/client.tsx |
Accepts migration-specific progress storage. |
scripts/validate-migration-items.spec.ts |
Tests collection-aware migration validation. |
scripts/validate-migration-items.mjs |
Adds multi-collection validation. |
includes/migration/flutter-v10/telemetry-callbacks.mdx |
Adds telemetry callback migration guidance. |
includes/migration/flutter-v10/span-attributes.mdx |
Adds span attribute migration guidance. |
includes/migration/flutter-v10/sentry-packages.mdx |
Adds package migration guidance. |
includes/migration/flutter-v10/sensitive-content.mdx |
Adds sensitive-content migration guidance. |
includes/migration/flutter-v10/removed-apis.mdx |
Documents removed APIs. |
includes/migration/flutter-v10/native-failed-requests.mdx |
Adds native failed-request guidance. |
includes/migration/flutter-v10/minimum-versions.mdx |
Documents minimum versions. |
includes/migration/flutter-v10/logs-and-metrics.mdx |
Adds logs and metrics migration guidance. |
includes/migration/flutter-v10/http-error-capture.mdx |
Adds HTTP error capture guidance. |
includes/migration/flutter-v10/flutter-web.mdx |
Adds Flutter web migration guidance. |
includes/migration/flutter-v10/feature-flags.mdx |
Adds feature flag migration guidance. |
includes/migration/flutter-v10/error-processing.mdx |
Adds error processing migration guidance. |
includes/migration/flutter-v10/desktop-crash-reporting.mdx |
Adds desktop crash reporting guidance. |
includes/migration/flutter-v10/callback-failures.mdx |
Adds callback failure guidance. |
includes/migration/flutter-v10/apple-swift-package-manager.mdx |
Adds Apple Swift Package Manager guidance. |
includes/migration/flutter-v10/app-start.mdx |
Adds app-start migration guidance. |
includes/migration/flutter-v10/android-kotlin.mdx |
Adds Android Kotlin migration guidance. |
includes/flutter-v10-migration-overview.mdx |
Provides migration highlights. |
includes/flutter-v10-agent-migration.mdx |
Adds the agent-assisted migration prompt. |
docs/platforms/dart/guides/flutter/migration/v9-to-v10/interactive.mdx |
Adds the interactive checklist. |
docs/platforms/dart/guides/flutter/migration/v9-to-v10/index.mdx |
Adds the full migration guide. |
docs/platforms/dart/guides/flutter/migration/index.mdx |
Links the new migration resources. |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Include the Android minimum and required minSdk setting in the shared migration guide content. Refs getsentry/sentry-dart#4049 Co-Authored-By: Codex <noreply@openai.com>
2 tasks
Document the planned SDK default change and the explicit transaction-mode fallback. Co-Authored-By: Codex <noreply@openai.com>
Update the checklist count and verify the stream-default item is loaded. Co-Authored-By: Codex <noreply@openai.com>
Show previous and new requirements together and identify Android minSdk in the table. Co-Authored-By: Codex <noreply@openai.com>
Clarify terminal unhandled sessions and sampled-out Dart errors in the migration guide. Co-Authored-By: Codex <noreply@openai.com>
Co-Authored-By: Codex <noreply@openai.com>
Keep the opening paragraph within the migration validator limit. Preserve the existing explanation of cross-request deduplication. Co-Authored-By: Codex <noreply@openai.com>
buenaflor
added this pull request to stack #19758
October 1, 2026 12:43
antonis
approved these changes
Oct 2, 2026
antonis
left a comment
antonis
left a comment
Contributor
There was a problem hiding this comment.
LGTM 🚀
I did a manual proof reading and a fact check with Claude and didn't find any issues.
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Document the Flutter v9-to-v10 migration with a dedicated full guide and a companion interactive checklist, matching the JavaScript migration experience. The guide covers platform requirements, removed APIs, and telemetry behavior changes for v10.
Closes getsentry/sentry-dart#4023
IS YOUR CHANGE URGENT?
Help us prioritize incoming PRs by letting us know when the change needs to go live.
Select exactly one option. For deadlines, replace
YYYY-MM-DDwith the due date. You can update this information later by editing the PR description.SLA
Thanks in advance for your help!
PRE-MERGE CHECKLIST
Make sure you've checked the following before merging your changes:
LEGAL BOILERPLATE
Look, I get it. The entity doing business as "Sentry" was incorporated in the State of Delaware in 2015 as Functional Software, Inc. and is gonna need some rights from me in order to utilize my contributions in this here PR. So here's the deal: I retain all rights, title and interest in and to my contributions, and by keeping this boilerplate intact I confirm that Sentry can use, modify, copy, and redistribute my contributions, under Sentry's choice of terms.
EXTRA RESOURCES