Skip to content

Get started

Install Pelagic UI

One package for your framework plus @pelagic-ui/core for the styles and tokens.

1. Install and import the styles

Install · React
npm i @pelagic-ui/react @pelagic-ui/core

// main.tsx
import '@pelagic-ui/core/style.css';

2. Use a component

Button · React
<Button>Save</Button>
<Button variant="outline">Preview</Button>
<Button variant="danger" loading>Deleting</Button>

3. Supported versions

FrameworkSupported versions
React18 and 19
Vue3.4 and up
Angular20, 21 and 22
Svelte5
Astro5 (the @pelagic-ui/astro package)
React Native0.74 and up, including Expo
Three.js (3D)0.160 and up
FlutterThe pelagic_ui package on pub.dev

4. Pick a theme

By default Pelagic UI follows the operating system: light, dark, or high contrast. Override it any time.

Theme · React
import { applyTheme, saveTheme } from '@pelagic-ui/react';
applyTheme({ mode: 'dark', accent: 'indigo', shape: 'round' });
Right-to-left
Set dir="rtl" on <html> and every component mirrors automatically.

Search Pelagic UI