📁 radixui/themes/docs

File: docs.md | Updated: 11/15/2025

Source: https://www.radix-ui.com/themes/docs

Radix Homepage

Made by WorkOS

Radix Homepage

Made by WorkOS

ThemesThemes PrimitivesPrimitives IconsIcons ColorsColors

Documentation Playground Blog

Overview

Getting started Styling Layout Releases Resources

Theme

Overview Color Dark mode Typography Spacing Breakpoints Radius Shadows Cursors

Layout

Box Flex Grid Container Section

Typography

Text Heading Blockquote Code Em Kbd Link Quote Strong

Components

Alert Dialog Aspect Ratio Avatar Badge Button Callout Card Checkbox Checkbox Group Checkbox Cards Context Menu Data List Dialog Dropdown Menu Hover Card Icon Button Inset Popover Progress Radio Radio Group Radio Cards Scroll Area Segmented Control Select Separator Skeleton Slider Spinner Switch Table Tabs Tab Nav Text Area Text Field Tooltip

Utilities

Accessible Icon Portal Reset Slot Theme Visually Hidden

Overview

Getting started

Install Radix Themes and start building in minutes.

Radix Themes is a pre-styled component library that is designed to work out of the box with minimal configuration. If you are looking for the unstyled components, go to Radix Primitives .

Installation


Getting up and running is quick and easy.

1. Install Radix Themes

Install the package from your command line.

npmnpmyarnyarnpnpmpnpm

npm install @radix-ui/themes

2. Import the CSS file

Import the global CSS file at the root of your application.

import "@radix-ui/themes/styles.css";

3. Add the Theme component

Add Theme to your application, wrapping the root component inside of body.

import { Theme } from "@radix-ui/themes";

export default function () {
	return (
		<html>
			<body>
				<Theme>
					<MyApp />
				</Theme>
			</body>
		</html>
	);
}

4. Start building

You are now ready to use Radix Themes components.

import { Flex, Text, Button } from "@radix-ui/themes";

export default function MyApp() {
	return (
		<Flex direction="column" gap="2">
			<Text>Hello from Radix Themes :)</Text>
			<Button>Let's go</Button>
		</Flex>
	);
}

Customizing your theme


Configuration is managed and applied via the Theme component.

Basic configuration

Pass configuration to the Theme to customize appearance.

<Theme accentColor="crimson" grayColor="sand" radius="large" scaling="95%">
	<MyApp />
</Theme>

Using the theme panel

ThemePanel is a drop-in component that allows you to preview the theme in real time. Visit the component playground to see it in action.

To add ThemePanel to your app, import it from the package and drop it inside your root Theme.

import { Theme, ThemePanel } from "@radix-ui/themes";

export default function () {
	return (
		<Theme>
			<MyApp />
			<ThemePanel />
		</Theme>
	);
}

Take it further

Get the most out of Radix Themes by exploring more concepts and features.

Styling

Learn how to approach styling and overrides with Radix Themes.
Layout

Get to know the layout primitives and their available properties.
Theme overview

Anatomy of a theme and how to create the perfect style for your app.
Color

Understand the color system and its application in your theme.
Dark mode

Integrate a great looking dark mode into your app using appearances.
Typography

Add custom typefaces and fine tune typographic details.

NextStyling

Edit this page on GitHub.

📁 Children

Directory listing - 3 item(s) total