English | 中文

Introduction

Since the release of Ant Design X 1.0 on November 22 last year, many developers have chosen X to build AI applications. We are grateful for your support. Given the rapid development of AI and the many changes along the way, we discovered several areas for improvement during the adoption of X. Combined with feedback from community issues, we began planning for the X 2.0 version in April this year. Today, we're excited to announce the official release of Ant Design X V2!

This upgrade focuses on:

1. Upgrading the underlying dependency to Ant Design V6, introducing updates for React 19 and a new CSS Variables styling architecture.
2. Ant Design X 2.0 has been restructured into a monorepo with three sub-packages: @ant-design/x, @ant-design/x-markdown, and @ant-design/x-sdk. As a result, Ant Design X is now a toolkit for building AI applications.

If you plan to use Ant Design X 2.0:

• You need to upgrade Ant Design to version 6.
• React is recommended to upgrade to version 19 (minimum version requirement is now React 18).
• The V1 branch will switch to v1.x-stable and enter a six-month maintenance cycle; we will only provide critical bug fixes, and no further functional updates for V1.
  
  

Technical Upgrades

Ant Design Dependency Upgraded to V6
For upgrading Ant Design to V6, please see: Ant Design V5 - V6 Migration Guide (Chinese)

• 🌈 Pure CSS Variables styling architecture
• 🚫 IE is no longer supported
• 🧩 Semantic structure for all components
• ⚛ Minimum React version requirement raised to 18

New Features and Improvements

Core UI Component Library (@ant-design/x)

A RICH-paradigm-based React UI component library. It provides plug-and-play intelligent chat interface components and atomic components that support flexible combinations.

• TypeScript support
• Semantic structure for components
• Customizable internationalization
• Deep theme customization

🔥 Bubble Components Fully Upgraded

1. Complete refactor of Bubble and Bubble.List, with new variants, shapes, extended rendering, streaming rendering, animation, editable bubbles, and enhanced scrollable content in Bubble.List.

2. New sub-message components: Bubble.System and Bubble.Divider

🔥 Sender Input Component Fully Upgraded

1. Slot-based mode now available, allowing for customizable functions and multiple operation methods.

2. The actions config has been removed, expanded into four positions: header, footer, prefix, and suffix.

🔥 ThoughtChain Component Fully Upgraded

1. Visual interactions improved for long-task execution processes.

2. Introduced simple ThoughtChain.Item with multiple available types and statuses.

🔥 FileCard Component

2. Rendering of file lists is now easier as well.
   

3. Designed image loading capabilities for multimodal models (for best effect please visit the official website).
   

🆕 Think Process Component
A new "Think" component for visualizing the thought process, works best with X Markdown.

🆕 Sources Citation Component
A new "Sources" component for content citation, works best with X Markdown (for effect please visit the official website).

🆕 Notification System Component
Native notification control component. Provides notification sending, delayed closing, specific notification closing, as well as both hook and static method calls.

🆕 Actions List

1. Added preset capabilities such as Copy, Feedback, and Audio interactions, in addition to custom actions.
   

2. Designed for content generation with large language models, adds rendering animation including lateral gradient and fade effects.
   

🆕 Attachments Input
New file type selection support: Set multiple to true to enable multi-selection, and maxCount to limit the number of files.

🆕 Conversations Management
Improved grouping and quick-add conversation shortcuts.

🆕 XProvider

1. Supports component-level internationalization (currently Chinese and English by default; more languages welcome via contribution).
   
2. Upgraded theme config: Customize token, classname(s), and style(s) for all Antd, Antd X, and Antd X Markdown components from XProvider.
   
3. Shortcut key support for components.

High-Performance Markdown Streaming Renderer (@ant-design/x-markdown)

High-performance Markdown streaming renderer (@ant-design/x-markdown)

🔥 Streaming syntax handling
Supports buffering and completion for incomplete Markdown syntax.

🔥 Streaming animations

🔥 Components
Custom component extension for Markdown, can detect streaming status for loading effects.

🔥 Plugin suite
Built-in LaTeX, Mermaid, code highlighting, and open Marked hooks for customization.

1. LaTeX
   

2. Mermaid
   

3. Code highlighting
   

4. Custom plugins
   

Data Flow & SDK Toolkit (@ant-design/x-sdk)

Provides API tools for managing data flows in AI chat applications.

🔥 useXChat
Manages session data with Agents, outputs renderable data for UI.

🔥 useXConversations
Manages session lists, supports session creation, deletion, update, etc.

🔥 Chat Provider
Includes DefaultChatProvider, OpenAIChatProvider, DeepSeekChatProvider, and supports custom providers for different models and agents.

🏗️ XRequest & XStream
Stream requests and processing migrated to X-SDK.

Upgrade Guide

• Make sure to upgrade Ant Design to v6.
• Your project must run on React 18 or higher.
• Regarding @ant-design/x,
  • We have fully upgraded the Sender, ThoughtChain, and Bubble components in terms of UI and features. Please refer to your application page design to select components, as there is no universal migration tool, but we do provide upgrade documentation (link placeholder).
  • In v2, all Tools-related content has migrated to @ant-design/x-sdk, and useXAgent has been removed. Please use the new useXChat instead; for more functionality, see the official X-SDK site (link placeholder).
• IE is no longer supported.

Future Plans

• X-Pro: An AI application scaffolding tool based on X.
• Content generation standards and integration schemes for AI applications: x-card is still in design—the details will be posted in X Discussions.
• More built-in Chat Providers for different model vendors.
• More component functions triggered by shortcuts.
• Other new components in development, e.g., GenScroller (generative scrolling), Artifacts (micro browser), etc. Stay tuned.

Final Words

Thank you to everyone who contributed to Ant Design X 2.0. — Your participation makes open source wonderful.

Chuck-Ray
Div627
hy993658052
kimteayon
Rain120
vanndxh
afc163
anxLiang
IsDyh01
elrrrrrrr
hylin
iamkun-2
coding-ice
yuguaa
fireairforce