TL;DR
Shadcn/UI has changed its default UI framework from Radix to Base UI. This update, confirmed by the maintainers, affects how developers implement components and influences the library’s future direction.
Shadcn/UI has officially changed its default UI framework from Radix to Base UI, a move confirmed by the project maintainers. This change impacts developers who rely on the library for building user interfaces, as it alters the default component setup and influences the development workflow.
The update was announced by the Shadcn/UI team in March 2024 through their official repository and communication channels. Previously, Radix was the default framework integrated into Shadcn/UI for accessibility and component behavior, but now, Base UI is set as the default, streamlining the setup process for new projects.
The switch was motivated by the maintainers’ goal to simplify the library’s architecture and to better align with the evolving UI ecosystem. The change is currently in effect, with existing projects able to switch back to Radix if desired. The transition involves updates to the default configuration and documentation to reflect the new setup.
Implications for Developers Using Shadcn/UI
This change is significant because it influences how developers integrate and customize UI components in their projects. Base UI offers a different approach to styling and component behavior compared to Radix, which was known for its accessibility features and composability. Developers now need to adapt their workflows and potentially modify existing codebases to align with the new default framework.
By shifting to Base UI, the Shadcn/UI project signals a strategic move towards a more streamlined and possibly more flexible UI toolkit. The change may also impact the broader ecosystem, as other libraries and frameworks that depend on Shadcn/UI could follow suit or adapt accordingly.

Learning React: Modern Patterns for Developing React Apps
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Background on Shadcn/UI and Its Framework Choices
Shadcn/UI is a popular open-source component library designed to facilitate rapid UI development with a focus on simplicity and accessibility. Previously, it defaulted to Radix, a well-regarded framework known for its focus on accessible and customizable components.
The choice of Radix as the default was driven by its robustness and community support. However, as the UI development landscape evolves, the Shadcn/UI team announced in early 2024 that they would switch the default to Base UI, a newer framework that emphasizes ease of use and integration with modern design systems.
This decision reflects broader industry trends toward simplified UI toolkits and modular design, aiming to reduce complexity for developers and improve performance.
“The switch to Base UI as the default framework aligns with our goal to provide a more streamlined and flexible development experience for our users.”
— Shadcn/UI Maintainers
accessible UI component toolkit
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Unresolved Questions About Transition and Compatibility
It is not yet clear how the transition will impact existing projects that rely heavily on Radix components. The extent of backward compatibility and whether there will be migration tools or guides remains to be seen. Additionally, the long-term implications for the ecosystem and third-party integrations are still developing.

The MERN Stack Manual: A Project-Based Approach to Building Full-Stack Applications with MongoDB, Express, React, and Node.js
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Next Steps for Developers and the Shadcn/UI Project
Developers should monitor the official repository and documentation updates for guidance on transitioning existing projects to the new default. The Shadcn/UI team is expected to release migration resources and clarify support policies for Radix-based setups. Future releases may also include new features tailored to Base UI integration, shaping the library’s evolution.
Radix UI alternative
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Key Questions
Why did Shadcn/UI switch from Radix to Base UI?
The switch was made to streamline the library’s architecture, improve ease of use, and align with modern UI development trends, according to the maintainers.
Will existing projects using Radix be affected?
Existing projects will not be immediately affected but will need to consider migration if they want to adopt the new default. Support and migration guides are expected to be released soon.
What are the main differences between Radix and Base UI?
Radix is known for its accessibility and composability, while Base UI emphasizes simplicity, quick setup, and integration with modern design systems.
How will this change impact third-party integrations?
It remains to be seen, but developers should stay updated on compatibility and integration guidance from the Shadcn/UI team.
What should developers do now?
Monitor official updates, review documentation, and prepare for potential migration efforts if they rely on Radix components.
Source: hn