# @bronzelabs/tribe-ui

> The Tribe Project's design system for the web

Latest version **2.4.0** (published 2026-04-20) · MIT license · 0 weekly downloads

## Install

```sh
npm install @bronzelabs/tribe-ui
pnpm add @bronzelabs/tribe-ui
yarn add @bronzelabs/tribe-ui
bun add @bronzelabs/tribe-ui
```

## Health

**Score 60/100 (C)** — status: stable.

Positive: has types; esm support; no vulnerabilities; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 2.4.0 |
| Published | 2026-04-20 |
| First published | 2023-02-15 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM |
| Dependencies | 11 |
| Unpacked size | 247.2 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Maintainers | nathanhughes, jamiegough |

## Links

- npm: https://www.npmjs.com/package/@bronzelabs/tribe-ui
- npm.io page: https://npm.io/package/@bronzelabs/tribe-ui

## Dependencies (11)

- [clsx](https://npm.io/package/clsx.md) ^2.0.0
- [motion](https://npm.io/package/motion.md) >=12.0.0
- [dompurify](https://npm.io/package/dompurify.md) ^3.1.7
- [react-select](https://npm.io/package/react-select.md) ^5.10.2
- [lodash.uniqby](https://npm.io/package/lodash.uniqby.md) ^4.7.0
- [react-number-format](https://npm.io/package/react-number-format.md) ^5.3.3
- [@react-google-maps/api](https://npm.io/package/@react-google-maps/api.md) ^2.18.1
- [@bronzelabs/tribe-icons](https://npm.io/package/@bronzelabs/tribe-icons.md) *
- [@radix-ui/react-popover](https://npm.io/package/@radix-ui/react-popover.md) ^1.0.7
- [@radix-ui/react-hover-card](https://npm.io/package/@radix-ui/react-hover-card.md) ^1.0.7
- [@bronzelabs/tribe-tailwind-preset](https://npm.io/package/@bronzelabs/tribe-tailwind-preset.md) *

## Recent versions

- 2.4.0 (latest) — 2026-04-20
- 2.3.1 — 2026-04-08
- 2.3.0 — 2026-04-08
- 2.2.3 — 2026-04-01
- 2.2.2 — 2026-03-30
- 2.2.1 — 2026-03-30
- 2.2.0 — 2026-03-26
- 2.1.2 — 2026-03-12
- 2.1.1 — 2026-02-24
- 2.1.0 — 2026-02-10
- 2.0.1 — 2026-02-10
- 1.2.10 — 2025-10-28
- 1.2.9 — 2025-10-03
- 1.2.8 — 2025-10-02
- 1.2.7 — 2025-07-10
- … 93 more at https://npm.io/package/@bronzelabs/tribe-ui/versions

## README

# Tribe UI

The Tribe Project's design system for the web.

![](https://img.shields.io/npm/v/@bronzelabs/tribe-ui)

- [Installation](#installation)
- [Setup](#setup)
- [Usage](#usage)

## Installation

```sh
npm i @bronzelabs/tribe-ui @bronzelabs/tribe-icons @bronzelabs/tribe-tailwind-preset
```

Then install peer dependencies:

```sh
npm i react react-dom next motion
```

## Setup

The Tribe Project uses tailwind as its styling solution. If you don't already have tailwind setup within your project head to the [tailwindcss docs](https://tailwindcss.com/docs/installation/framework-guides).

Begin by adding the `tribe-tailwind-preset` to your tailwind config:

```js
import tribe from "@bronzelabs/tribe-tailwind-preset"

/** @type {import('tailwindcss').Config} */
module.exports = {
  content: [
    /* ... */
  ],
  presets: [tribe],
  plugins: [],
}
```

### Caveat

Currently you'll need to add the design system source files to the content field of your `tailwind.config.js` so they are picked up by the compiler.

```jsx #5
import tribe from "@bronzelabs/tribe-tailwind-preset"

/** @type {import('tailwindcss').Config} */
module.exports = {
  content: [
    /* ... */
    "node_modules/@bronzelabs/tribe-ui/dist/**/*.{js,jsx}", // <----
  ],
  presets: [tribe],
  plugins: [],
}
```

> **N.B.** This behaviour is not ideal and we are looking for more stable ways round this.

## Usage

To use a component from the design system, simply import and render it within you jsx:

```jsx
import React from "react"
import { Button } from "@bronzelabs/tribe-ui"

const MyPage = () => {
  return (
    <div>
      <Button>Hello World</Button>
    </div>
  )
}

export default MyPage
```

For more in-depth explanations of how to use specific components, check out the [storybook](https://tribe-design-storybook.vercel.app/).

---
_Source: https://npm.io/package/@bronzelabs/tribe-ui · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
