ant-design

Ant Design

S - Scope

• Target: antd@^6 + React 18-19, with ant-design-pro@^5 / @ant-design/pro-components and @ant-design/x@^2 when needed.
• Tooling: @ant-design/cli for offline component metadata, demos, changelogs, migrations, linting, doctor checks, and usage analysis.
• Focus: decision guidance only; no end-user tutorials.
• Source policy: official docs only; no undocumented APIs or internal .ant-* coupling.

Default assumptions

• Language: TypeScript.
• Styling: tokens first, then classNames/styles; avoid global overrides.
• Provider: one root ConfigProvider unless strict isolation is required.

Mandatory rules

• Before writing or changing antd component code, query the component API first with antd info <Component> --format json. Do not rely on memory when the CLI can answer it offline.
• Always use --format json with antd CLI commands.
• If the project version matters, match it with --version <x.y.z> or let the CLI auto-detect from local node_modules.
• After changing antd code, run antd lint <changed-path> --format json.
• If an antd CLI command crashes, returns wrong data, or violates its documented behavior, prepare an antd bug-cli preview for user confirmation instead of silently working around it.
• For component questions, first map the component name to the official route slug {components} (lowercase kebab-case, e.g. TreeSelect -> tree-select, Button -> button), then request docs in this order (CN first, EN fallback):
  1. https://ant.design/components/{components}-cn
  2. https://ant.design/components/{components}
  • Examples: tree-select-cn -> tree-select, button-cn -> button.
• Use only documented antd/Pro/X APIs.
• Do not invent props/events/component names.
• Do not rely on internal DOM or .ant-* selectors.
• Theme priority: global tokens -> component tokens -> alias tokens.

P - Process

1) Classify

• Identify layer: core antd, Pro, or X.
• Confirm version, rendering mode (CSR/SSR/streaming), data scale, and whether @ant-design/cli should be the primary lookup path.