SDDS (Plasma)

Дизайн-система для веб-приложений на React. Репозиторий содержит ядро компонентов и пакеты конечных продуктовых вертикалей.

Вертикаль — это готовый набор компонентов со своими темами и конфигурацией для конкретного продукта или направления.

С чего начать

1. Выберите пакет вертикали в таблице ниже.
2. Установите пакет и его тему по инструкции из README пакета или со страницы документации.
3. Импортируйте компоненты из пакета вертикали, например import { Button } from '@salutejs/sdds-serv'.

Пакеты компонентов

Пакет	README	Документация	Storybook
@salutejs/plasma-web	README	web	web-storybook
@salutejs/plasma-b2c	README	b2c	b2c-storybook
@salutejs/plasma-giga	README	giga	giga-storybook
@salutejs/plasma-homeds	README	homeds	homeds-storybook
@salutejs/sdds-serv	README	sdds-serv	sdds-serv-storybook
@salutejs/sdds-cs	README	sdds-cs	sdds-cs-storybook
@salutejs/sdds-bizcom	README	sdds-bizcom	sdds-bizcom-storybook
@salutejs/sdds-dfa	README	sdds-dfa	sdds-dfa-storybook
@salutejs/sdds-finai	README	sdds-finai	sdds-finai-storybook
@salutejs/sdds-insol-next	README	sdds-insol-next	sdds-insol-next-storybook
@salutejs/sdds-netology	README	sdds-netology	sdds-netology-storybook
@salutejs/sdds-platform-ai	README	sdds-platform-ai	sdds-platform-ai-storybook
@salutejs/sdds-sbcom	README	sdds-sbcom	sdds-sbcom-storybook
@salutejs/sdds-scan	README	sdds-scan	sdds-scan-storybook
@salutejs/sdds-os	README	—	sdds-os-storybook

!!ВАЖНО!!: Пакет plasma-ui переехал в отдельный репозиторий salute-developers/plasma-ui.

Темы и иконки

• @salutejs/plasma-themes и @salutejs/sdds-themes содержат темы и дизайн-токены вертикалей. Какой пакет тем нужен вашей вертикали, указано в README её пакета.
• @salutejs/plasma-icons и @salutejs/sdds-icons содержат React-иконки. Весь набор можно посмотреть на странице иконок.

Для AI-агентов

• Компоненты, их свойства и примеры для вертикали отдаёт MCP-сервер @salutejs/sdds-mcp. Список поддерживаемых пакетов и настройка описаны в разделе «Как работать с MCP» документации вертикали. Запуск:

  npx -y @salutejs/sdds-mcp@latest --lib <пакет-вертикали>

• llms.txt есть у сайта документации в каждой вертикали есть и находится по адресу <сайт документации>/llms.txt, например https://plasma.sberdevices.ru/sdds-serv/llms.txt.

• В коде приложения импортируйте компоненты и токены только из пакета вертикали и её пакета тем, а иконки из пакета иконок. Остальные пакеты в packages/, включая ядро plasma-new-hope, служат зависимостями вертикалей и напрямую не подключаются.

• Для работы внутри этого репозитория следуйте AGENTS.md.

Разработка

• AGENTS.md описывает структуру монорепозитория, команды сборки и проверок, навыки агентов.
• CONTRIBUTING.md содержит правила внесения изменений.

Обратная связь

Чтобы предложить новый компонент, пришлите пулл-реквест по правилам разработки или заведите задачу. Там же можно сообщить о некорректном поведении существующего компонента.