Installation

Install

npm install @shellapps/react-ui

Peer Dependencies

React 18+ (react, react-dom)

npm install react react-dom

Basic Setup

Wrap your app with ThemeProvider:

import { ThemeProvider } from '@shellapps/react-ui';
import '@shellapps/react-ui/styles.css';
 
function App() {
  return (
    <ThemeProvider theme="default" mode="system">
      <YourApp />
    </ThemeProvider>
  );
}

Usage

Import components directly:

import { Button, Card, Input } from '@shellapps/react-ui';
 
function LoginForm() {
  return (
    <Card>
      <Card.Header>Sign In</Card.Header>
      <Card.Body>
        <Input label="Email" type="email" />
        <Input label="Password" type="password" />
        <Button variant="primary" fullWidth>
          Sign In
        </Button>
      </Card.Body>
    </Card>
  );
}

Tree Shaking

The library supports tree shaking out of the box. Only the components you import are included in your bundle.

TypeScript

Full type definitions are included — no extra @types package needed.

Components — Full component catalogue
Theming — Configure themes and modes

Theming Overview