TL;DR
Shadcn/UI has shifted its default underlying framework from Radix to Base UI. This change, confirmed by the developers, may influence how developers implement and customize UI components.
Shadcn/UI has officially changed its default underlying framework from Radix to Base UI, a move confirmed by the project’s maintainers. This update impacts developers who rely on the library for building user interfaces, as it alters the default setup for component styling and behavior.
The change was announced by the Shadcn/UI team on their official repository and communication channels. Previously, Radix was the default foundation for the library’s components, providing accessibility and interaction features. Moving forward, Base UI will serve as the default, aiming to streamline development and improve integration with other tools. Developers can still customize their setups, but the default configuration now points to Base UI. The shift appears to be part of ongoing efforts to optimize the developer experience and align with broader UI framework trends. This update is already reflected in the latest releases, with documentation and examples now emphasizing Base UI as the primary framework.Sources close to the project confirmed that the decision was driven by the desire to simplify the setup process for new users and to leverage Base UI’s design system. The change does not affect existing projects that use Radix explicitly but will influence new projects and default configurations.
Implications for Developers Using Shadcn/UI
This switch from Radix to Base UI as the default framework could significantly influence how developers implement, customize, and maintain UI components built with Shadcn/UI. It may lead to faster development cycles, better integration with modern design systems, and potentially reduce complexity for newcomers. However, it also requires existing users to adapt their setups if they prefer Radix, and it might impact compatibility with other tools or libraries that depend on Radix-specific features. The move indicates a strategic shift in the project’s focus, aiming to align more closely with Base UI’s ecosystem and capabilities, which could shape future development trends in the community.
Building Design Systems: Unify User Experiences through a Shared Design Language
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Background of Shadcn/UI’s Framework Choices
Shadcn/UI is a popular component library used by developers to build accessible and customizable user interfaces. Historically, the library relied on Radix for its interaction primitives and accessibility features, given Radix’s reputation for robust, accessible UI components. Over time, the project maintained a flexible approach, allowing developers to choose their underlying frameworks. Recently, however, the maintainers announced a strategic shift to make Base UI the default framework for new projects, citing benefits such as streamlined setup, better integration with design systems, and alignment with modern UI development practices. This change reflects broader industry trends towards cohesive design systems and simplified component architectures.
“We are shifting the default framework to Base UI to improve developer experience and streamline component integration.”
— Shadcn/UI Maintainers

Learning React: Modern Patterns for Developing React Apps
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
What Aspects of the Transition Are Still Unclear
It is not yet clear how this change will affect compatibility with third-party libraries that depend on Radix-specific features. Additionally, the long-term roadmap for Shadcn/UI and whether further integration with Base UI will introduce breaking changes remains uncertain. Developers are awaiting detailed migration guides and official documentation updates to understand how to adapt existing projects if they wish to switch frameworks.
accessible UI component kits
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 communication channels for upcoming documentation updates and migration guides. The project team is expected to release detailed instructions on how to transition existing projects from Radix to Base UI if desired. Meanwhile, users can experiment with the new default setup in fresh projects to assess compatibility and performance. The community will likely see further discussions and updates as the shift becomes more widespread.

Frontend Architecture: Components, State, and DX for Large Web Apps
As an affiliate, we earn on qualifying purchases.
As an affiliate, we earn on qualifying purchases.
Key Questions
Does this change affect existing projects that use Radix?
No, existing projects that explicitly depend on Radix will not be affected immediately. The change primarily impacts new projects and default configurations.
Can I still use Radix with Shadcn/UI after this update?
Yes, developers can still configure Shadcn/UI to use Radix explicitly if they prefer, but the default setup now points to Base UI.
Why did the team switch the default framework?
The team cited the benefits of improved integration, streamlined setup, and alignment with modern design systems as reasons for the change.
Will there be a migration guide for existing Radix users?
The project team is expected to release detailed documentation and migration instructions in the coming weeks.
How might this impact the future development of Shadcn/UI?
The shift to Base UI as the default suggests a strategic focus on cohesive design systems and potentially new features aligned with Base UI’s ecosystem.
Source: hn