The magic of Tailwind with the flexibility of css-in-js.

🌟 New: Twin v3 now includes full Tailwind plugin support and more
Release notes →

--- Style jsx elements using Tailwind classes: ```js import 'twin.macro' const Input = () => ``` Nest Twin’s `tw` import within a css prop to add conditional styles: ```js import tw from 'twin.macro' const Input = ({ hasHover }) => ( ) ``` Or mix sass styles with the css import: ```js import tw, { css } from 'twin.macro' const hoverStyles = css` &:hover { border-color: black; ${tw`text-black`} } ` const Input = ({ hasHover }) => ( ) ``` ### Styled Components You can also use the tw import to create and style new components: ```js import tw from 'twin.macro' const Input = tw.input`border hover:border-black` ``` And clone and style existing components: ```js const PurpleInput = tw(Input)`border-purple-500` ``` Switch to the styled import to add conditional styling: ```js import tw, { styled } from 'twin.macro' const StyledInput = styled.input(({ hasBorder }) => [ `color: black;`, hasBorder && tw`border-purple-500`, ]) const Input = () => ``` Or use backticks to mix with sass styles: ```js import tw, { styled } from 'twin.macro' const StyledInput = styled.input` color: black; ${({ hasBorder }) => hasBorder && tw`border-purple-500`} ` const Input = () => ``` ## How it works When babel runs over your javascript or typescript files at compile time, twin grabs your classes and converts them into css objects. These css objects are then passed into your chosen css-in-js library without the need for an extra client-side bundle: ```js import tw from 'twin.macro' tw`text-sm md:text-lg` // ↓ ↓ ↓ ↓ ↓ ↓ { fontSize: '0.875rem', '@media (min-width: 768px)': { fontSize: '1.125rem', }, } ``` ## Features **👌 Simple imports** - Twin collapses imports from common styling libraries into a single import: ```diff - import styled from '@emotion/styled' - import css from '@emotion/react' + import { styled, css } from 'twin.macro' ``` **🐹 Adds no size to your build** - Twin converts the classes you’ve used into css objects using Babel and then compiles away, leaving no runtime code **🍱 Apply variants to multiple classes at once with variant groups** ```js import 'twin.macro' const interactionStyles = () => (

) const mediaStyles = () =>

const pseudoElementStyles = () =>

const stackedVariants = () =>

const groupsInGroups = () =>

``` **🛎 Helpful suggestions for mistypings** - Twin chimes in with class and variant values from your Tailwind config: ```bash ✕ ml-1.25 was not found Try one of these classes: - ml-1.5 > 0.375rem - ml-1 > 0.25rem - ml-10 > 2.5rem ``` **🖌️ Use the theme import to add values from your tailwind config** ```js import { css, theme } from 'twin.macro' const Input = () => ``` See more examples [using the theme import →](https://github.com/ben-rogerson/twin.macro/pull/106) **💡 Works with the official tailwind vscode plugin** - Avoid having to look up your classes with auto-completions straight from your Tailwind config - [setup instructions →](https://github.com/ben-rogerson/twin.macro/discussions/227) **💥 Add !important to any class with a trailing or leading bang!** ```js

||

// ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓

``` Add !important to multiple classes with bracket groups: ```js

// ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓ ↓

``` ## Get started Twin works with many modern stacks - take a look at these examples to get started: ### App build tools and libraries - **Parcel**
[styled-components](https://github.com/ben-rogerson/twin.examples/tree/master/react-styled-components) / [emotion](https://github.com/ben-rogerson/twin.examples/tree/master/react-emotion) / [emotion (ts)](https://github.com/ben-rogerson/twin.examples/tree/master/react-emotion-typescript) - **Webpack**
[styled-components (ts)](https://github.com/ben-rogerson/twin.examples/tree/master/webpack-styled-components-typescript) / [emotion (ts)](https://github.com/ben-rogerson/twin.examples/tree/master/webpack-emotion-typescript) - **Preact**
[styled-components](https://github.com/ben-rogerson/twin.examples/tree/master/preact-styled-components) / [emotion](https://github.com/ben-rogerson/twin.examples/tree/master/preact-emotion) / [goober](https://github.com/ben-rogerson/twin.examples/tree/master/preact-goober) - **Create React App**
[styled-components](https://github.com/ben-rogerson/twin.examples/tree/master/cra-styled-components) / [emotion](https://github.com/ben-rogerson/twin.examples/tree/master/cra-emotion) - **Vite**
[styled-components (ts)](https://github.com/ben-rogerson/twin.examples/tree/master/vite-styled-components-typescript) / [emotion (ts)](https://github.com/ben-rogerson/twin.examples/tree/master/vite-emotion-typescript) / [solid (ts)](https://github.com/ben-rogerson/twin.examples/tree/master/vite-solid-typescript) 🎉 - **Jest / React Testing Library**
[styled-components (ts) / emotion (ts)](https://github.com/ben-rogerson/twin.examples/tree/master/jest-testing-typescript) ### Advanced frameworks - **Next.js**
[styled-components](https://github.com/ben-rogerson/twin.examples/tree/master/next-styled-components) / [styled-components (ts)](https://github.com/ben-rogerson/twin.examples/tree/master/next-styled-components-typescript) / [emotion](https://github.com/ben-rogerson/twin.examples/tree/master/next-emotion) / [emotion (ts)](https://github.com/ben-rogerson/twin.examples/tree/master/next-emotion-typescript) / [stitches (ts)](https://github.com/ben-rogerson/twin.examples/tree/master/next-stitches-typescript) - **T3 App**
[styled-components (ts)](https://github.com/ben-rogerson/twin.examples/tree/master/t3-styled-components-typescript) 🎉 / [emotion (ts)](https://github.com/ben-rogerson/twin.examples/tree/master/t3-emotion-typescript) 🎉 - **Blitz.js**
[emotion (ts)](https://github.com/ben-rogerson/twin.examples/tree/master/blitz-emotion-typescript) - **Gatsby**
[styled-components](https://github.com/ben-rogerson/twin.examples/tree/master/gatsby-styled-components) / [emotion](https://github.com/ben-rogerson/twin.examples/tree/master/gatsby-emotion) ### Component libraries - **Storybook**
[styled-components (ts)](https://github.com/ben-rogerson/twin.examples/tree/master/storybook-styled-components-typescript) / [emotion](https://github.com/ben-rogerson/twin.examples/tree/master/storybook-emotion) / [emotion (ts)](https://github.com/ben-rogerson/twin.examples/tree/master/storybook-emotion-typescript) 🎉 - **yarn/npm workspaces + Next.js + shared ui components**
[styled-components](https://github.com/ben-rogerson/twin.examples/tree/master/component-library-styled-components) - **Yarn workspaces + Rollup**
[emotion](https://github.com/ben-rogerson/twin.examples/tree/master/component-library-emotion) - [**HeadlessUI** (ts)](https://github.com/ben-rogerson/twin.examples/tree/master/headlessui-typescript) ## Community [Drop into our Discord server](https://discord.gg/Xj6x9z7) for announcements, help and styling chat.

## Resources - 🔥 [Docs: The prop styling guide](https://github.com/ben-rogerson/twin.macro/blob/master/docs/prop-styling-guide.md) - A must-read guide to level up on prop styling - 🔥 [Docs: The styled component guide](https://github.com/ben-rogerson/twin.macro/blob/master/docs/styled-component-guide.md) - A must-read guide on getting productive with styled components - [Docs: Options](https://github.com/ben-rogerson/twin.macro/blob/master/docs/options.md) - Learn about the features you can tweak via the twin config - [Plugin: babel-plugin-twin](https://github.com/ben-rogerson/babel-plugin-twin) - Use the tw and css props without adding an import - [Example: Advanced theming](https://github.com/ben-rogerson/twin.macro/blob/master/docs/advanced-theming.md) - Add custom theming the right way using css variables - [Example: React + Tailwind breakpoint syncing](https://gist.github.com/ben-rogerson/b4b406dffcc18ae02f8a6c8c97bb58a8) - Sync your tailwind.config.js breakpoints with react - [Helpers: Twin VSCode snippets](https://gist.github.com/ben-rogerson/c6b62508e63b3e3146350f685df2ddc9) - For devs who want to type less - [Plugins: VSCode plugins](https://github.com/ben-rogerson/twin.macro/discussions/227) - VScode plugins that work with twin - [Article: "Why I Love Tailwind" by Max Stoiber](https://mxstbr.com/thoughts/tailwind) - Max (inventor of styled-components) shares his thoughts on twin ## Special thanks This project stemmed from [babel-plugin-tailwind-components](https://github.com/bradlc/babel-plugin-tailwind-components) so a big shout out goes to [Brad Cornes](https://github.com/bradlc) for the amazing work he produced. Styling with tailwind.macro has been such a pleasure.

	Stars	Issues	Version	Updated	Created
@emotion/react			11.13.3	a month ago	5 years ago
@stitches/react	7,731	119	1.2.8	2 years ago	4 years ago
styled-components	40,376	282	6.1.13	18 days ago	8 years ago
twin.macro	7,896	18	3.4.1	8 months ago	5 years ago

@emotion/react vs @stitches/react vs styled-components vs twin.macro

Downloads in past1 Month3 Months6 Months1 Year2 Years5 YearsAll time

Stats

Sick of boring JavaScript newsletters?

Downloads in past