* feat: add pro-upgrade skill for AI-assisted project upgrades
Add a Claude Code skill and Codex-compatible instructions that enable
AI agents to upgrade Ant Design Pro projects by diffing the latest
template and intelligently merging framework changes while preserving
business code. Works for any version gap (v5→v6, v6.x→latest, etc.).
Closesant-design/ant-design-pro#11800
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
* chore: revert AGENTS.md to simple link to CLAUDE.md
CLAUDE.md already contains the Upgrading section, no need to
duplicate in AGENTS.md.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
* chore: replace AGENTS.md with symlink to CLAUDE.md
Avoid duplicating content — Codex reads AGENTS.md which now points
directly to CLAUDE.md where all guidance (including the pro-upgrade
skill reference) lives.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
* docs: add upgrade FAQ to cheatsheets
Add guidance for upgrading Ant Design Pro projects using the
pro-upgrade skill in both Chinese and English cheatsheets.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
* docs: add skill install instructions to upgrade FAQ
Users upgrading from older versions won't have the skill file,
so provide a curl command to download it from the latest template.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
* docs: use npx skills add for skill installation
Replace curl command with `npx skills add ant-design/ant-design-pro`
in both cheatsheets.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
* fix: address PR review feedback
- Preflight warning: change from Chinese-only to English
- Dependency merging: preserve user deps not found in template by default
- antd migrate: use version placeholders instead of hardcoded "5 6"
- Business files: use recursive glob src/services/**/*.ts
- Cheatsheet: temper "upgrade" to "assist" to avoid overpromising
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
- Add v6 release link in both READMEs
- Update tech stack references (Umi Max 4, utoopack, Tailwind CSS v4)
- Add AI Assistant feature in feature list
- Update Templates section to match current routes
- Remove Opera from browser support table
- Add "What's New in v6" section in cheatsheets
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
* feat: rewrite Welcome page with two-column layout
Replace centered single-card layout with a two-column design:
left column (2/3 width) renders a Markdown cheatsheet via
@ant-design/x-markdown, right column (1/3 width) shows three
InfoCard links. Add locale-aware content switching using
useLocale from @umijs/max with ?raw markdown imports.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* feat: improve Welcome cheatsheet with i18n, responsive layout, and build compatibility
- Use useIntl/formatMessage for InfoCard text (consistent with project convention)
- Add i18n keys to zh-CN/en-US locale files for InfoCard content
- Add responsive breakpoint (mobile stack, desktop side-by-side)
- Add aria-label to InfoCard links for accessibility
- Convert docs/*.md to docs/*.ts (utoopack doesn't support ?raw imports)
- Use @root alias for doc imports instead of relative paths
- Remove unnecessary useState/useEffect, derive content directly from locale
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* docs: add cheatsheet design spec and implementation plan
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* chore: ignore docs/superpowers from git tracking
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* fix: use getLocale instead of non-existent useLocale
@umijs/max exports getLocale(), not useLocale() hook.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* fix: import XMarkdown CSS for proper markdown styling
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* feat: add comprehensive markdown typography styles for cheatsheet
XMarkdown's built-in CSS only provides skeleton layout (margins, word-break).
Add antd-style createStyles with full typography using antd design tokens:
- Heading sizes (h1-h6) with proper font-weight and margins
- Link colors (colorLink/colorLinkHover)
- Code blocks with background, border, and rounded corners
- Inline code with subtle background
- Blockquotes with left border and tinted background
- Tables with borders, header background, and hover rows
- Horizontal rules and strong text
All colors adapt to light/dark theme automatically via tokens.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* refactor: replace antd-style with plain CSS for markdown typography
Use a dedicated Welcome.css with CSS custom properties for light/dark mode,
instead of antd-style createStyles. Simpler, no runtime overhead.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* fix: use Card component and compact InfoCard layout
- Left markdown: replace div wrapper with antd Card component
- Right InfoCards: use Card with size=small and hoverable for white bg
- Reduce badge size (h-10/w-10) and text size for compact cards
- Reduce gap between cards from 6 to 4
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* feat: add heading anchor links and dark code block background
- Add hash anchor links to h1-h4 headings via XMarkdown components prop
- Anchor (#) appears on hover, clicking scrolls to heading
- Code blocks use dark background (#1e1e2e) with light text
- Remove code block border for cleaner look
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* feat: add syntax highlighting for code blocks with highlight.js
- Use highlight.js via XMarkdown config (marked highlight option)
- Light theme: github-gist (white background, standard colors)
- Dark theme: custom GitHub Dark overrides (.dark selector)
- Keywords red, strings blue, comments gray, numbers blue, builtins orange
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* feat: add syntax highlighting and improve heading anchors
- Code blocks: override XMarkdown's code renderer to use highlight.js
(XMarkdown's internal renderer escapes HTML, bypassing marked's
highlight option)
- Heading anchors: replace inline <a> with CSS ::before pseudo-element,
# only appears on hover via absolute positioning, no layout shift
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* fix: heading anchor # shows inline on hover
Use inline <a> with opacity toggle instead of absolute positioned
::before which was clipped by Card overflow.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* docs: add simple mode explanation to Getting Started
Explain what npm run simple does (strips demo pages and deps,
irreversible) and warn to commit code first.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* fix: heading anchor styles not applied
- Merge incoming className instead of overriding it (ensures CSS
selectors match)
- Fix id generation: React children from XMarkdown Renderer are
React nodes not strings, extract textContent properly
- Remove unused domNode prop from type
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* fix: heading anchor # positioned absolutely, no layout shift
Use position: absolute with negative left offset so the #: does not
occupy character space in the heading text flow.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* docs: explain full mode vs simple mode in Getting Started
Add section after project creation explaining the two project modes,
and recommend starting with full mode for learning then switching.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* fix: merge all class prop variants from XMarkdown Renderer
XMarkdown Renderer passes class as className, classname, or class
depending on the source. Merge all three and don't spread rest
(some props like domNode are not valid HTML attributes).
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* style: move heading anchor # closer to title text
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* docs: soften simple mode warning — git can revert, not truly irreversible
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* docs: add explicit bash commands for simple mode switch
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* docs: use git clone instead of create-umi for project setup
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* fix: apply GitHub Dark theme for code blocks in dark mode
Override highlight.js github-gist (white) theme with GitHub Dark color
scheme when .dark class is active. Fix white background on code blocks,
add syntax token colors, and style inline code for dark backgrounds.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* fix: dark mode code blocks and add banner image
- Detect dark mode via initialState.settings.navTheme and apply .dark
class to wrapper div, enabling CSS dark overrides and Tailwind dark:
utilities
- Configure Tailwind darkMode: 'class' strategy
- Fix TypeScript errors for XMarkdown non-standard class props
- Remove unused import and ...rest spread in Heading component
- Add banner image below markdown title in both locales
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* refactor: use raw markdown files with utoopack raw-loader
- Convert docs/welcome.*.ts to docs/cheatsheet.*.md (pure markdown)
- Configure utoopack module.rules to load .md files as raw strings
- Add .md module type declaration in src/typings.d.ts
- Update Welcome.tsx imports from .ts to .md
- Add utoopack/bundler info and utoo.land link in cheatsheet docs
- Add cheatsheet links in README.md and README.zh-CN.md
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* fix: add Jest mock for .md imports and update README links
- Add moduleNameMapper for .md files in jest.config.ts to return mock
string, placed before umi aliases to ensure match priority
- Create tests/__mocks__/raw.js as the mock module for .md imports
- Replace pro.ant.design doc/faq links in READMEs with cheatsheet links
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* docs: replace pro.ant.design links with local cheatsheet and GitHub releases
Pro.ant.design is being decommissioned. Replace Documentation and FAQ
links with local cheatsheet md files, ChangeLog with GitHub releases.
Remove Home Page links that pointed to pro.ant.design.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* Delete pnpm-lock.yaml
* fix: revert utoopack raw-loader and use .ts wrappers for markdown content
utoopack does not support module.rules type:'raw' for .md files. Revert
to TypeScript wrapper files that export markdown as template literals.
Changes:
- Add docs/cheatsheet.zh-CN.ts and docs/cheatsheet.en-US.ts as .ts
wrappers (markdown content with proper escaping)
- Revert utoopack module.rules config for .md files
- Remove .md type declaration from src/typings.d.ts
- Remove Jest moduleNameMapper for .md and tests/__mocks__/raw.js
- Update Welcome.tsx imports from .md back to .ts
- Fix openapi.json typo (was oneapi.json) in both docs
- Improve locale fallback: zh* locales fall back to zh-CN, others to en-US
- Refactor InfoCard rendering to data-driven map pattern
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
afc163
Claude
jiaxiang