Введение

Oracul DS — это коллекция красиво оформленных, доступных и композируемых компонентов для ваших React-приложений. Построенная на основе Base UI и стилизованная с помощью Tailwind CSS, она создана для того, чтобы вы могли копировать, вставлять и владеть кодом.

Мы считаем, что Base UI — это лучший фундамент для современных веб-приложений. Мы взяли его мощные примитивы без стилей и наделили их системой дизайна, которая готова к использованию прямо из коробки.

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

Быстрый старт

Установите ваш первый компонент прямо сейчас:

bunnpmpnpmyarn
pnpm dlx shadcn@latest add https://ds.oracul.co/ui/r/{name}.json
Копировать

Или настройте поле registries в components.json, чтобы использовать короткие команды:

bunnpmpnpmyarn
pnpm dlx shadcn@latest add @oracul/button
Копировать

Как это работает

Наш подход прост: вы должны владеть своим кодом. Мы вдохновлены философией копирования и вставки (copy-paste), заложенной в shadcn/ui.

Вместо установки пакета вы получаете исходный код. Это означает:

• Никаких абстракций: У вас есть полный контроль над тем, как компоненты выглядят и ведут себя.
• Безграничная кастомизация: Нужно что-то изменить? Просто отредактируйте файл.
• Обучение в процессе: Посмотрите, как построены компоненты, и адаптируйте их под свои нужды.

Построено на Base UI, готово к продакшену

Oracul DS построена на Base UI с самого начала, а не как адаптация или порт с Radix UI. Мы выбрали Base UI за его надежные, доступные и независимые примитивы, которые берут на себя сложные части (доступность, навигация с клавиатуры, управление фокусом), не навязывая конкретных дизайнерских решений.

Oracul DS — это не просто повторная реализация shadcn. Это создание согласованной и продуманной системы пользовательского интерфейса, адаптированной для реальных высоконагруженных приложений. Наши компоненты и паттерны выходят за рамки базовых примитивов и включают:

• Проверенные в продакшене паттерны из реальных приложений.
• Расширенные варианты компонентов для частых случаев использования.
• Продуманные значения по умолчанию, оптимизированные для современных интерфейсов.
• Единая система дизайна для всех компонентов.

Если вы переходите с shadcn/ui или Radix UI, мы предоставляем подробное руководство по миграции для плавного перехода.

Примитивы, Частицы и Атомы

В основе Oracul DS лежат UI Primitives — доступные строительные блоки без стилей на базе Base UI. Это фундамент: низкоуровневые компоненты, которые управляют доступностью и взаимодействием.

Над примитивами мы вводим Частицы (Particles). Частицы — это предварительно собранные компоненты, такие как формы аутентификации, таблицы или календари, которые объединяют несколько примитивов в готовые к использованию решения.

Наконец, мы идем еще дальше с Атомами (Atoms). Атомы — это компоненты, которые не просто управляют состоянием интерфейса локально, но и интегрируются с внешними данными и сервисами. Это «умные» компоненты, которые связывают UI с API.

Вместе примитивы, частицы и атомы дают вам полный спектр инструментов:

• Примитивы → фундамент
• Частицы → паттерны
• Атомы → интеграции

Этот многослойный подход позволяет выбрать нужный уровень абстракции для вашего проекта — от «голого» примитива до готового решения с интеграцией API.

Создано для Людей и ИИ

Мы строим инфраструктуру как для людей, так и для ИИ. Наши компоненты написаны максимально ясно, читаемо и предсказуемо, чтобы языковые модели могли понимать их, изменять и дополнять.

Открытый код (Open Source)

Этот проект является частью философии Oracul. Мы верим, что открытый код работает лучше всего, когда он прозрачен и доступен. Мы предоставляем инструменты, документацию и инфраструктуру, чтобы ваша работа процветала.

Мы с нетерпением ждем возможности увидеть, что вы создадите с помощью Oracul DS, и всегда рады вашему участию, отзывам и улучшениям.

Присоединяйтесь

Мы всегда ищем контрибьюторов. Будь то отчет об ошибке, новая функция или обновление документации — мы ценим вашу помощь.

Проверьте наши рекомендации по участию на GitHub. Вы можете найти открытые задачи и отправить свои изменения (Pull Requests) в наш репозиторий.