Migration Guide

Upgrade from previous versions of NH-UI

Migrating to NH-UI 1.0

Current

NH-UI 1.0 is built on top of HeroUI 2.8.x with custom theming and components. If you're migrating from a different UI library, follow these steps:

1. Install NH-UI

npm install @noiseheroes/ui # or yarn add @noiseheroes/ui # or pnpm add @noiseheroes/ui

2. Update your imports

// Before import { Button, Card } from "your-old-ui-library"; // After import { NHButton, NHCard } from "@noiseheroes/ui";

3. Update component props

NH-UI components follow HeroUI's prop conventions. See individual component documentation for specific prop mappings.

4. Theme configuration

NH-UI comes with a pre-configured theme based on the Noise Heroes brand. See the Colors and Typography sections for details.

Breaking Changes

No breaking changes yet - this is the first stable release of NH-UI.

Need Help?

If you encounter any issues during migration, please:

  • Check the component documentation for updated usage
  • Review the changelog for recent updates
  • Open an issue on our GitHub repository
HeroUI • Build: 2025-08-04T19:49:46.182Z