Secretmakewomenwomen/auric-ui

AuricUI is a React component library aimed at AI-facing interfaces: it bundles basic controls, chat and tool-call components, and timeline/layer/project panels for editors in one visual system, with dark and light themes. Teams already building React applications with AI assistants or Agent workbenches, rather than general-purpose sites, are the most direct fit.

What it provides

Components are split into entry points by scenario: auricui for buttons, forms, tables, drawers and the theme provider; auricui/agent for messages, citations, tool execution, action confirmation and memory; auricui/chat for rich-text input, Markdown and model menus; and auricui/studio for timeline, layers, assets, projects and editor components. A demo entry supplies local mock data, and auricui/styles.css ships compiled styles, fonts and animations so no Tailwind setup is required (component entry points).

How a workflow looks

After installing into an existing project, you import the stylesheet and mount AuricUIProvider once at the root, passing a theme; the provider drives CSS variables such as --bg and --text. Setting <html data-theme="dark"> in the initial HTML keeps the first paint consistent. Base and Agent components connect to business logic through props and callbacks. Some Chat and Studio composite components expect service adapters supplied by the application for model calls, project persistence and media processing — the full documentation scenarios use local mocks for those behaviors, so you cannot take the demo as a working backend (setup example).

A distinguishing part is the optional coding-agent Skill, installed with npx auricui-skill@latest into .agents/skills/auricui (or globally with --global). It is loaded on demand: the agent searches components and queries a single component's props instead of loading the whole index, and props are meant to come from the version actually installed. The Skill only installs guides and tools — the component library still comes from npm — and its dependency and API-query scripts require Python 3 (Skill guide).

Requirements and limits

The library targets React 19 and React DOM 19 projects. Installation uses the next npm preview channel, which the README says may lag behind the repository source, so the lockfile is the authority on the installed version. Source development needs Node.js 22.12+, npm and tar, with Node 22 from .nvmrc recommended; full validation also needs Python 3. Build and check commands cover type declarations, ESM imports, SSR, browser builds and documentation example compilation, but the README states UI interactions still need browser verification (running the docs).

Licence

The project is MIT-licensed, but some Chat/Studio UI and browser algorithms come from OpenFilm under a separate MIT licence, and fonts, service icons and other dependencies have their own notices, so redistributors should carry those through (third-party notices).