# uiheat

> Install UI Heat theme, components, landing blocks and helpers into any shadcn project.

Latest version **2.1.0** (published 2026-11-16) · MIT license · 0 weekly downloads

## Install

```sh
npm install uiheat
pnpm add uiheat
yarn add uiheat
bun add uiheat
```

Provides the command `uiheat`.

## Health

**Score 65/100 (B)** — status: active.

Positive: esm support; no vulnerabilities; has provenance; recently updated; high maintenance score.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 2.1.0 |
| Published | 2026-11-16 |
| First published | 2023-10-01 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM |
| Node | >=18.17 |
| Dependencies | 1 |
| Unpacked size | 17.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 1 |
| Author | Dominique Hosea |
| Maintainers | hoseacodes |
| Keywords | shadcn, registry, components, tailwind, nextjs |

## Links

- npm: https://www.npmjs.com/package/uiheat
- Repository: https://github.com/HoseaCodes/ui-library
- Homepage: https://github.com/HoseaCodes/ui-library#readme
- Issues: https://github.com/HoseaCodes/ui-library/issues
- npm.io page: https://npm.io/package/uiheat

## Dependencies (1)

- [shadcn](https://npm.io/package/shadcn.md) 4.23.0

## Alternatives

- [@sveltejs/kit](https://npm.io/package/@sveltejs/kit.md) — 2.2M weekly downloads
- [@tangle-network/brand](https://npm.io/package/@tangle-network/brand.md) — 10.0K weekly downloads
- [seneca](https://npm.io/package/seneca.md) — 7.4K weekly downloads
- [@bsb/base](https://npm.io/package/@bsb/base.md) — 7.2K weekly downloads
- [@modern-js/plugin-swc](https://npm.io/package/@modern-js/plugin-swc.md) — 3.4K weekly downloads

## Recent versions

- 2.1.0 (latest) — 2026-11-16
- 2.0.0 — 2026-11-16
- 1.0.1 — 2023-10-01
- 1.0.0 — 2023-10-01

## README

# uiheat

Install the UI Heat theme, components, landing page blocks and helpers into any
React project. Components are copied into your project as source (via
[shadcn](https://ui.shadcn.com)), so you can edit them freely.

```bash
npx uiheat create my-site          # new Next.js app, themed, starter components installed
npx uiheat add landing-page        # add items to the current project
npx uiheat list                    # see everything available
```

## Commands

| Command | What it does |
|---|---|
| `uiheat create <name>` | New Next.js + Tailwind app with the UI Heat theme, starter components, and providers wired into `app/layout.tsx` |
| `uiheat init` | Prepare an existing project: writes `components.json` if missing, adds the UI Heat registry, adds a `cn()` helper if missing. Never overwrites files |
| `uiheat add <items...>` | Add items. Runs `init` first if needed |
| `uiheat list` | List items with descriptions |

UI Heat items can be named bare (`landing-hero`) or namespaced
(`@uiheat/landing-hero`). Anything else (`button`, `accordion`, …) comes from
shadcn's own registry. Flags such as `--overwrite`, `--yes` and `--dry-run` are
passed through to shadcn, and `-c <dir>` runs against another directory.

## Items

- **Foundation:** `theme`, `starter`, `theme-provider`, `mode-toggle`
- **Components:** `spinner`, `image-dropzone`
- **Landing page:** `landing-page` (everything), or individually `landing-header`,
  `landing-hero`, `landing-how-it-works`, `landing-testimonials`, `landing-faq`,
  `landing-contact`, `landing-footer`, `contact-api`
- **Dashboard:** `dashboard` (shell + example layout), or just `dashboard-shell`
- **Auth (Firebase):** `auth-pages` (login/sign-up/reset pages), `firebase-auth`, `firebase`
- **Auth (Expo / React Native):** `auth-screens-native` (login/sign-up/reset screens),
  `firebase-auth-native`, `firebase-native`, `theme-native`
- **Server helpers:** `mongodb`, `logger`

Run `npx uiheat list` for descriptions.

## Notes

- In an existing app that already has its own `components/ui/button.tsx` (or
  similar), skip `starter` and the landing blocks, or the install will stop and
  ask before replacing those files.
- In an Expo project, `init` writes a `components.json` without CSS or Tailwind
  settings, and `add` runs `npx expo install --fix` afterwards so native packages
  match your Expo SDK.
- Set `UIHEAT_REGISTRY_URL` to point at a different registry, e.g. a local one
  while developing: `http://localhost:4000/r/{name}.json`.

> Versions before 2.0 were a small React component package. 2.0 replaces it with
> this installer.

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