Quick Start

Get up and running with Boreal UI in just a few steps.

1. Install the Package

2. Wrap with ThemeProvider

Enable theming by wrapping your app in ThemeProvider:

3. Import Global Styles

Next.js

In your globals.css or globals.scss:

Then in _app.tsx or layout.tsx:

React (Core)

In your main entry file:

4. Set Global Defaults

Customize global styling using setBorealStyleConfig (must run before rendering any components):

You can still override styles per component:

5. Import Components

React (Core):

Next.js (Optimized):

6. (Optional) Add a Custom Color Scheme

To define your own color palette, pass an array of custom schemes to the ThemeProvider using the customSchemes prop:

Set this scheme as the default using the config API:

Verify Your Setup

  • All components render with styles applied
  • Custom color scheme loads via ThemeProvider
  • Global config values are respected
  • No console errors or missing styles