Об этом проекте

Braid — это настраиваемая дизайн-система для SEEK Group, опубликованная в npm под названием braid-design-system. В README описана настройка, оптимизированная для проектов sku: установите пакет, затем в самом верху приложения сначала импортируйте сброс стилей (reset styles), чтобы избежать проблем с порядком CSS, импортируйте тему (например, seekJobs), а также BraidProvider и компоненты. Провайдер принимает проп theme и отрисовывает компоненты; также можно отключить стили body с помощью styleBody={false}. Для настройки реализации Link и TextLink (например, для интеграции ссылок React Router) через makeLinkComponent можно передать пользовательский компонент ссылки через linkComponent. Локальная разработка осуществляется с использованием pnpm и Storybook. Braid использует Vanilla Extract для стилизации, создавая CSS на TypeScript, который статически извлекается в атомарные CSS-классы, что требует плагина бандлера. Для проверки использования компонентов применяются runtime-утверждения из библиотеки assert; в README рекомендуется удалять их в продакшене с помощью unassert, что реализовано через sku и Babel. Предупреждения времени разработки и сборки, такие как уведомления об устаревании, зависят от process.env.NODE_ENV и могут быть удалены из продакшн-сборок. Информация о внесении вклада содержится в CONTRIBUTING.md. Выражается благодарность Chromatic за тестирование скриншотов компонентов на базе Storybook. Лицензия — MIT.