Overview
Deprecations are an essential part of maintaining a healthy and scalable design system. Deprecation is the process of phasing out components, patterns, or tokens that are no longer aligned with current design or development standards. This typically happens when better alternatives are introduced, when existing solutions cause inconsistency or confusion, or when updates to accessibility, performance, or usability guidelines make older implementations obsolete.
“Deprecation” does not mean “immediate removal”. It simply means that something is marked as “should not use” as early as possible, remaining available to use as-is until the next SWAN major version removes it. Where possible, a deprecation will include a recommendation on the migration path, including a codemod (if possible), which automates the migration process for you.
A list of deprecations per SWAN version are listed below. Deprecations are also marked in code, in the Changelog, on relevant documentation pages, and in Figma.
SWAN v3 deprecations
The preview has been updated.
Prior deprecations
Removed in v3.0.0
The preview has been updated.