> ## Documentation Index
> Fetch the complete documentation index at: https://docs.twenty.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Команды фронтенда

## Полезные команды

### Запуск приложения

```bash theme={null}
npx nx start twenty-front
```

### Перегенерировать схему graphql на основе схемы API graphql

```bash theme={null}
npx nx run twenty-front:graphql:generate --configuration=metadata
```

ИЛИ

```bash theme={null}
npx nx run twenty-front:graphql:generate
```

### Линт

```bash theme={null}
npx nx run twenty-front:lint # pass --fix to fix lint errors
```

## Переводы

```bash theme={null}
npx nx run twenty-front:lingui:extract
npx nx run twenty-front:lingui:compile
```

### Тест

```bash theme={null}
npx nx run twenty-front:test # run jest tests
npx nx run twenty-front:storybook:serve:dev # run storybook
npx nx run twenty-front:storybook:test # run tests # (needs yarn storybook:serve:dev to be running)
npx nx run twenty-front:storybook:coverage # (needs yarn storybook:serve:dev to be running)
```

## Технологический стек

Проект имеет чистый и простой стек с минимальным кодом.

**Приложение**

* [React](https://react.dev/)
* [Apollo](https://www.apollographql.com/docs/)
* [GraphQL Codegen](https://the-guild.dev/graphql/codegen)
* [Jotai](https://jotai.org/)
* [TypeScript](https://www.typescriptlang.org/)

**Тестирование**

* [Jest](https://jestjs.io/)
* [Storybook](https://storybook.js.org/)

**Инструменты**

* [Yarn](https://yarnpkg.com/)
* [Craco](https://craco.js.org/docs/)
* [Oxlint](https://oxc.rs/docs/guide/usage/linter.html)

## Архитектура

### Маршрутизация

[React Router](https://reactrouter.com/) обрабатывает маршрутизацию.

Чтобы избежать ненужных [перерисовок](/l/ru/developers/contribute/capabilities/frontend-development/best-practices-front#managing-re-renders), вся логика маршрутизации находится в `useEffect` в `PageChangeEffect`.

### Управление состоянием

[Jotai](https://jotai.org/) отвечает за управление состоянием.

[лучшие практики](/l/ru/developers/contribute/capabilities/frontend-development/best-practices-front#state-management) для получения дополнительной информации об управлении состоянием.

## Тестирование

[Jest](https://jestjs.io/) служит инструментом для модульного тестирования, а [Storybook](https://storybook.js.org/) — для тестирования компонентов.

Jest в основном используется для тестирования утилит, а не самих компонентов.

Storybook предназначен для тестирования поведения изолированных компонентов, а также для отображения системы дизайна.