Welcome to Soft UI
Soft UI is a comprehensive design system for React and Next.js applications, providing 70+ production-ready components built on Base UI primitives with Tailwind v4.70+ Components
From buttons to complex data tables, dialogs, menus, forms, and navigation components
Base UI Primitives
Built on top of Base UI for accessibility and behavior
Design Tokens
Theme-aware color system with live theme and base color switching
TypeScript First
Fully typed components with IntelliSense support
Tailwind v4
Powered by the latest Tailwind CSS for modern styling
Subpath Imports
Import only what you need with component-level subpaths
Architecture
Soft UI is a monorepo with three core packages:- @soft-ui/tokens - Design tokens, CSS entrypoints, and theme initialization
- @soft-ui/icons - Swappable icon adapter with Remix Icons as default implementation
- @soft-ui/react - 70+ UI components with subpath imports
Design System Features
Token-Driven Design
Colors, spacing, typography, and border radii are all controlled by design tokens that map to Tailwind scales
Live Theme Switching
Switch between 21 theme colors and 9 base colors using
data-theme-color and data-base-color attributesColor Schemes
Toggle between
mono (neutral primary actions) and color (themed primary actions) schemesTypography
Soft UI uses Inter Variable font with carefully chosen type scales:| Size | Font Size | Line Height |
|---|---|---|
| xs | 10px | 10px |
| s | 12px | 16px |
| m | 14px | 20px |
| l | 16px | 22px |
| xl | 18px | 24px |
| 2xl | 20px | 28px |
| 3xl | 24px | 32px |
Component Highlights
Soft UI includes components for every use case:Buttons
Button, IconButton, ToggleButton, ButtonGroup
Forms
Input, Textarea, Select, Checkbox, Radio, Switch, Slider, NumberField, FileUpload
Navigation
Menu, Tabs, Breadcrumbs, Pagination, CommandPalette
Overlays
Dialog, Popover, Tooltip, ContextMenu, AlertDialog
Data Display
Table, Avatar, AvatarGroup, Badge, Chip, Meter, Progress
Feedback
Toast, Banner, InlineNotification, EmptyState
Why Soft UI?
Soft UI takes the best parts of shadcn/ui’s component philosophy and combines it with Base UI’s accessible primitives, creating a cohesive design system that’s both beautiful and functional.
- Package-first approach - Install via npm, not copy-paste
- Base UI primitives - Accessibility and behavior handled for you
- Design tokens - Consistent theming across your entire application
- Subpath imports - Tree-shakeable imports for optimal bundle size
- TypeScript - Full type safety out of the box
- Tailwind v4 - Modern CSS with future-proof tooling
Next Steps
Installation
Set up Soft UI in your React or Next.js project
Quick Start
Build your first component in minutes