# @aircall/tractor

Aircall's legacy design system built on Styled Components.

Storybook: [https://tractor.aircall.io/latest/](https://tractor.aircall.io/latest/)

## Features

- Aircall Design System designed for web applications.
- A set of high-quality React components built with Styled Components.
- Written in TypeScript with predictable static types.
- Powerful theme customization in every detail.

## Install

```bash
pnpm add @aircall/tractor @aircall/icons @aircall/hooks
```

## Usage

```jsx
import { Button, Tractor } from '@aircall/tractor';

const App = () => (
  <Tractor injectStyle>
    <Button>Click me</Button>
  </Tractor>
);
```

> You **must** wrap your React tree with the `Tractor` provider, otherwise components won't have access to the theme.

## Theming

Tractor ships with Aircall brand specifications including colors, spacing, and typography variants. Stick with the defaults when possible.

For app-specific tokens, follow [these instructions](https://tractor.aircall.io/latest/?path=/docs/customization-theme--docs).

## Development

See the [monorepo README](https://gitlab.com/aircall/shared/hydra#%EF%B8%8F-development) for setup instructions.

## Contributing

See [CONTRIBUTION.md](./CONTRIBUTION.md).