What problem does it solve?
Deprecating APIs in the Flet framework requires coordinating runtime decorators, field-level validation metadata, version removal policies, and documentation updates across multiple files. This Skill standardizes that entire workflow so deprecations are consistent, correctly versioned, and properly rendered in docs.
Core Features & Use Cases
- Deprecation Pattern Selection: Guides the choice between
V.deprecated for fields, @deprecated for functions/methods, and @deprecated_class for controls, with ready-to-use code patterns.
- Version Lifecycle Management: Enforces the 3-minor-release removal policy and audits
delete_version entries matching a target release before shipping.
- Docs Integration: Ensures deprecations auto-render as admonitions and labels, and walks through migration guide creation, sidebar updates, and release notes edits.
- Use Case: When renaming a control property like
DragTargetEvent.x, use this Skill to add the correct V.deprecated annotation, set the removal version, and publish the grouped migration guide in one change.
Quick Start
Use the flet-deprecation skill to deprecate the old_prop field on ExampleControl with removal in version 0.20.0 and update the release docs.