Installation
Install the public SigmaUI 0.2.0 package in React or Next.js. No workspace packages, Tailwind setup, or backend credentials are required.
Install SigmaUI 0.2.0
Run this in your application directory. The published package includes components, types, themes, adaptive layout, and Motion. The starters use Node 22.13+ and React/React DOM 19.3.0, matching the package peer requirements.
npm install @sigma-ai/ui@0.2.0React setup
Import the compiled stylesheet once in src/main.tsx, then wrap your application in SigmaUIProvider. Download the React/Vite starter below for a complete TypeScript project with a lockfile and working examples.
import "@sigma-ai/ui/styles.css";
import { SigmaUIProvider, Card, Button } from "@sigma-ai/ui";
export default function App() {
return <SigmaUIProvider><Card title="Ready to build" headingLevel={1}>
<Button>Get started</Button>
</Card></SigmaUIProvider>;
}Next.js App Router setup
Import the stylesheet in app/layout.tsx. Keep pages and layouts as Server Components; add use client to components that use state, callbacks, providers, or browser APIs. The Next.js starter separates the server root from its interactive StarterDemo.
// app/layout.tsx
import "@sigma-ai/ui/styles.css";
// components/StarterDemo.tsx
"use client";
import { SigmaUIProvider, Button } from "@sigma-ai/ui";
export function StarterDemo() {
return <SigmaUIProvider><Button onClick={() => alert("Ready")}>Start</Button></SigmaUIProvider>;
}Motion and optional entries
The full stylesheet already includes Motion. Use motion.css only when you need the Motion stylesheet on its own; no extra animation dependency is required. Adaptive Layout can be imported on the server. The internal sigmaui and @sigmaui/* workspace packages are not required for either starter.
import { SigmaMotion, SigmaScratchCard } from "@sigma-ai/ui/motion";
import { Layout } from "@sigma-ai/ui/layout";
// Standalone Motion styling only:
// import "@sigma-ai/ui/motion.css";Download a starter kit
Choose React with Vite or Next.js App Router. Extract the ZIP, open its folder, run npm ci, then npm run dev. Both use the public package pinned to 0.2.0 and include project creation, theme controls, a dialog, scratch reveal, adaptive layout, and Motion. No local SigmaUI repository is needed.