---
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)