Fast, expressive styling for React.
Server components, client components, streaming SSR, React Native—one API.

--- styled-components is largely maintained by one person. Please help fund the project for consistent long-term support and updates: [Open Collective](https://opencollective.com/styled-components) --- Style React components with real CSS, scoped automatically and delivered only when needed. No class name juggling, no separate files, no build step required. - **Works everywhere React runs.** Server components, client components, streaming SSR, and React Native—same API, automatic runtime detection. - **Full CSS, no compromises.** Media queries, pseudo-selectors, nesting, keyframes, global styles. If CSS supports it, so does styled-components. - **TypeScript-first.** Built-in types ship with the package. Props flow through to your styles with full inference—no `@types` install, no manual generics. - **<13kB gzipped.** Small enough to disappear in your bundle. No build plugin required. ## Install ```sh npm install styled-components ```

pnpm / yarn

```sh pnpm add styled-components ``` ```sh yarn add styled-components ```

## Quick examples ### Dynamic props Vary styles based on component props. Prefix transient props with `$` to keep them off the DOM. ```tsx import styled from 'styled-components'; const Button = styled.button<{ $primary?: boolean }>` background: ${props => (props.$primary ? 'palevioletred' : 'white')}; color: ${props => (props.$primary ? 'white' : 'palevioletred')}; font-size: 1em; padding: 0.25em 1em; border: 2px solid palevioletred; border-radius: 3px; `; ``` ### Extending styles Build variants on top of existing styled components. ```tsx const TomatoButton = styled(Button)` background: tomato; color: white; border-color: tomato; `; ``` ### Polymorphic `as` prop Swap the rendered element without changing styles. ```tsx // Renders a tag with Button styles ``` ### Pseudos and nesting Use `&` to reference the component's generated class name—works with pseudo-classes, pseudo-elements, and nested selectors. ```tsx const Input = styled.input` border: 1px solid #ccc; border-radius: 4px; padding: 0.5em; &:focus { border-color: palevioletred; outline: none; } &::placeholder { color: #aaa; } `; ``` ### Animations Define `@keyframes` once, reference them across components. Names are scoped automatically. ```tsx import styled, { keyframes } from 'styled-components'; const rotate = keyframes` from { transform: rotate(0deg); } to { transform: rotate(360deg); } `; const Spinner = styled.div` animation: ${rotate} 1s linear infinite; width: 40px; height: 40px; border: 3px solid palevioletred; border-top-color: transparent; border-radius: 50%; `; ``` ### Theming Share design tokens across your app via React context. Every styled component receives `props.theme`. ```tsx import styled, { ThemeProvider } from 'styled-components'; const theme = { fg: 'palevioletred', bg: 'white', }; const Card = styled.div` background: ${props => props.theme.bg}; color: ${props => props.theme.fg}; padding: 2em; `; Themed content ``` ### RSC-compatible themes `createTheme` turns your tokens into CSS custom properties. Class name hashes stay stable across theme variants—no hydration mismatch when switching light/dark. ```tsx import styled, { createTheme, ThemeProvider } from 'styled-components'; const { theme, GlobalStyle: ThemeVars } = createTheme({ colors: { fg: 'palevioletred', bg: 'white', }, space: { md: '1rem', }, }); const Card = styled.div` color: ${theme.colors.fg}; /* var(--sc-colors-fg, palevioletred) */ background: ${theme.colors.bg}; padding: ${theme.space.md}; `; // Render at the root to emit the CSS variable declarations // Pass the theme to ThemeProvider for stable hashes Token-driven content ``` ### Shared styles with `css` Extract reusable style blocks to share across components or apply conditionally. ```tsx import styled, { css } from 'styled-components'; const truncate = css` white-space: nowrap; overflow: hidden; text-overflow: ellipsis; `; const Label = styled.span` ${truncate} max-width: 200px; `; ``` ### Styling third-party components Wrap any component that accepts a `className` prop. ```tsx import styled from 'styled-components'; import { Link } from 'react-router-dom'; const StyledLink = styled(Link)` color: palevioletred; text-decoration: none; &:hover { text-decoration: underline; } `; ``` ### Global styles Inject app-wide CSS like resets and font faces. Supports theming and dynamic updates. ```tsx import { createGlobalStyle } from 'styled-components'; const GlobalStyle = createGlobalStyle` body { margin: 0; font-family: system-ui, sans-serif; } `; // Render at the root of your app ``` ### Attrs Set default or static HTML attributes so consumers don't have to. ```tsx const PasswordInput = styled.input.attrs({ type: 'password', placeholder: 'Enter password', })` border: 1px solid #ccc; padding: 0.5em; `; ``` ## Documentation - [Getting started](https://styled-components.com/docs/basics) - [API reference](https://styled-components.com/docs/api) - [Server-side rendering](https://styled-components.com/docs/advanced#server-side-rendering) - [React Server Components](https://styled-components.com/docs/advanced#react-server-components) - [Theming](https://styled-components.com/docs/advanced#theming) - [React Native](https://styled-components.com/docs/basics#react-native) ## Community [Contributing guidelines](./CONTRIBUTING.md) | [Code of Conduct](./CODE_OF_CONDUCT.md) | [awesome-styled-components](https://github.com/styled-components/awesome-styled-components) ## Contributors This project exists thanks to all the people who contribute.

## Backers Thank you to all our backers! [[Become a backer](https://opencollective.com/styled-components#backer)]

## Sponsors Support this project by becoming a sponsor. [[Become a sponsor](https://opencollective.com/styled-components#sponsor)]

## Acknowledgements This project builds on earlier work by Charlie Somerville, Nik Graf, Sunil Pai, Michael Chan, Andrey Popp, Jed Watson, and Andrey Sitnik. Special thanks to [@okonet](https://github.com/okonet) for the logo. ## License Licensed under the MIT License, Copyright © 2016-present styled-components contributors. See [LICENSE](./LICENSE) for details.