@brand-studio/ui on npm

Components that wear your brand.

113 React components for apps, AI agents and story pages. Each one reads its colours, typeface and corners from a brand contract.

Read the install stepsnpm i @brand-studio/ui

Live components in your choice of brand

Brand for the board
{ "accent": "#c2410c", "font": "Geist", "radius": "18px" }
Voice Orb
You

How should I brew the new Huila beans?

Brew assistant

A pour-over brings out the red fruit. Want the recipe?

You

Yes, for one cup.

Brew assistant

For a 250 ml cup, use 15 g of coffee ground like coarse sand, and water around 94°C.

Chat Thread

Place a reorder?

The agent wants to buy your usual coffee.

orders.create({ item: "ethiopia-guji-250", quantity: 2 })
Approval Card

Launch email

1 of 5
  1. Read the brief, Done3s
  2. Collect product photos, In progress
  3. Draft the launch email, Not started
  4. Check links, Not started
  5. Schedule the send, Not started
Task Rows

Ethiopia Guji

Washed, light roast. Peach, jasmine and black tea.

250 gWhole bean
Card
Comparing roast notes
Agent Thinking
  • orders.search14 results, done
  • catalog.list, running
  • stock.checktimed out, failed
Tool Chips

One email on Monday with new roasts.

Not available in your region yet.

Switch

Every card is the real package. Still, Hollis and Deskhand are fictional brands.

Someone asks an agent for a launch page. The agent installs the components and the brand-design skill, writes a brand contract step by step, then real example pages scroll past. 40 seconds, no sound.

Take a phone apart.

This exploded view goes four levels deep: the logic board opens to the processor, and the processor to its silicon. Pick a layer, then a part, to zoom in.

Its colours and type come from the brand picked in the header.

Turn a 3x3 cube in 3D, take it apart and solve it in seven stages

Learn chess on a 3D board, one piece at a time

Learn xiangqi, Chinese chess, on a 3D board

Fig. 1PhoneHow a phone is built
Zoom into the charging coil12Zoom into the rear camerasZoom into the front cameraZoom into the logic boardZoom into the battery1234512Zoom into the screenFriday 16 October10:0812
  1. 2Front camera hole
  2. 1Power button2USB-C port
  3. 5Speaker
  4. 2Camera window
A phone comes apart into five layers. Pick a layer, then a part, to zoom in.

Create your brand assets.

The brand-design skill takes the same brand contract into character design, sticker-style artwork and icon exports.

Explore asset creation
Mascots
Define a character, build expression states and review SVG, PNG or optional 3D renders.
Sticker-style artwork
Use the mascot workflow to make outlined character artwork with a consistent silhouette and palette.
Icons and app icons
Check UI glyphs and export sprites, favicons and app icons for web, iOS and Android.
Contact sheet of Deskhand, an ink-black character with a yellow visor, in eight states: welcome, reading, drafting, waiting, sent, missing source, handoff and idle. Each state repeats at three small sizes.
The mascot workflow’s contact sheet for Deskhand, an example product: eight expression states, each checked at small sizes. The full sheet also reviews dark backgrounds, greyscale and blur.

Questions about the package

What is in @brand-studio/ui?
113 React components in 9 groups: Foundations, App, Navigation, Data, AI agents, Social, Effects, Storytelling, Product page. They cover app screens, AI agent interfaces, effects and story pages.
How does a component take on my brand?
Wrap the app in BrandTheme and pass a palette with light and dark tokens: surface, elevated, ink, muted, accent, onAccent, line, font and radius. BrandTheme sets them as CSS variables, and every component inside it reads them.
Which React versions does it support?
React 18.3 or newer, or React 19. React and React DOM are peer dependencies, and Base UI is the one runtime dependency.
Do I need Tailwind CSS?
No. The package ships one plain CSS file, @brand-studio/ui/styles.css, which you import once.
Where does the brand contract come from?
The brand-design skill writes it to brand/brand.json from your business facts, audience and category research. Install the skill with npx skills add hungduong-projects/brand-studio --skill brand-design, or write the palette by hand.
Can a coding agent read these docs?
Yes. Each docs page has a Markdown copy, /llms.txt lists them, and /llms-full.txt holds every page in one file.
What is the licence?
MIT. The source is on GitHub at hungduong-projects/brand-studio.