--- title: 'Introduction' --- Emotion is a library designed for writing css styles with JavaScript. It provides powerful and predictable style composition in addition to a great developer experience with features such as source maps, labels, and testing utilities. Both string and object styles are supported. --- There are two primary methods of using Emotion. The first is framework agnostic and the second is for use with React. ### Framework Agnostic ```bash npm i @emotion/css ``` **[`@emotion/css` documentation](https://emotion.sh/docs/@emotion/css)** The [@emotion/css](https://www.npmjs.com/package/@emotion/css) package is framework agnostic and the simplest way to use Emotion. - Requires no additional setup, babel plugin, or other config changes. - Has support for auto vendor-prefixing, nested selectors, and media queries. - You simply prefer to use the `css` function to generate class names and `cx` to compose them. - Server side rendering requires [additional work to set up](/docs/ssr.mdx#api) ```jsx // @live import { css } from '@emotion/css' const color = 'white' render(
Hover to change color.
) ``` ### React ```bash npm i @emotion/react ``` The [@emotion/react](https://www.npmjs.com/package/@emotion/react) package requires React and is recommended for users of that framework if possible. - Best when using React with a build environment that can be configured. - `css` prop support - Similar to the `style` prop, but also has support for auto vendor-prefixing, nested selectors, and media queries. - Allows developers to skip the `styled` API abstraction and style components and elements directly. - The `css` prop also accepts a function that is called with your theme as an argument allowing developers easy access to common and customizable values. - Reduces boilerplate when composing components and styled with emotion. - Server side rendering with zero configuration. - Theming works out of the box. - ESLint plugins available to ensure proper patterns and configuration are set. **[`@emotion/react` css prop documentation](/docs/css-prop.mdx)** ```jsx // @live import { css } from '@emotion/react' const color = 'white' render(
Hover to change color.
) ``` ```bash npm i @emotion/styled @emotion/react ``` The [@emotion/styled](https://www.npmjs.com/package/@emotion/styled) package is for those who prefer to use the `styled.div` style API for creating components. **[`@emotion/styled` documentation](/docs/styled.mdx)** ```jsx // @live import styled from '@emotion/styled' const Button = styled.button` padding: 32px; background-color: hotpink; font-size: 24px; border-radius: 4px; color: black; font-weight: bold; &:hover { color: white; } ` render() ``` ### Browser requirements Emotion supports all popular browsers and Internet Explorer 11. ### Libraries that Inspired Us - ["original" glam](https://github.com/threepointone/glam/tree/e9bca3950f12503246ed7fccad5cf13e5e9c86e3) - [glam](https://github.com/threepointone/glam) - [glamor](https://github.com/threepointone/glamor) - [styled-components](https://www.styled-components.com/) - [glamorous](https://glamorous.rocks)