Back to Ant Design

Ant Design Migration Guide

public/.well-known/agent-skills/antd-migration/SKILL.md

6.4.21.1 KB
Original Source

Ant Design Migration Guide

Migrate Ant Design projects between major versions, primarily v4 to v5.

When to Use

  • Upgrading from antd v4 to v5
  • Addressing deprecated component APIs
  • Replacing removed components or features
  • Converting from Less to CSS-in-JS styling

Instructions

  1. Review the migration guide at https://ant.design/docs/react/migration-v5
  2. Key migration steps from v4 to v5:
    • Replace less theme customization with ConfigProvider theme tokens
    • Update removed components: BackTopFloatButton.BackTop, Comment → use @ant-design/compatible
    • Replace message.useMessage(), notification.useNotification(), modal.useModal() hooks
    • Update deprecated props (check migration guide for full list)
  3. Use the @ant-design/codemod-v5 tool for automated migrations
  4. For the complete breaking changes list, fetch https://ant.design/llms-full.txt

Notes

  • Ant Design v5 drops Less in favor of CSS-in-JS
  • Class name prefixes changed; if you used ant- prefix class names, update to dynamic class names
  • Some component APIs have changed; check the migration guide for each component