27
Production-ready components
Alpha UI is a React component system for teams that want fast implementation and reliable defaults. It includes polished primitives, typed APIs, and predictable composition patterns.
27
Production-ready components
4
Organized component families
Type-safe
Typed props and stories included
Normal Details
This documentation focuses only on components already built in the library. Every section here is practical: install, compose, test states, and ship UI screens without custom glue code.
Technical Details
The docs are aligned with the package export surface to keep examples production-safe. Component usage, props, and grouped taxonomy are intentionally consistent with build output and typed APIs.
Install Alpha UI once, then import what you need. Tree-shaking keeps your bundle compact.
npm install alpha-ui-kitShuttle list for moving one or more items between lists. Includes both basic and enhanced interaction patterns.
Basic transfer list
Includes move selected and move all actions, matching the classic transfer-list pattern.
Choices
Chosen
Enhanced transfer list
Adds select-all/clear behavior and selected counters for each panel.
Choices
Chosen
import { TransferList } from 'alpha-ui-kit'
const items = [
{ value: 'item-1', label: 'List item 1' },
{ value: 'item-2', label: 'List item 2' },
{ value: 'item-3', label: 'List item 3' },
{ value: 'item-4', label: 'List item 4' },
{ value: 'item-5', label: 'List item 5' },
{ value: 'item-6', label: 'List item 6' },
{ value: 'item-7', label: 'List item 7' },
{ value: 'item-8', label: 'List item 8' },
]
export default function TransferExample() {
return (
<TransferList
items={items}
defaultValue={['item-5', 'item-6', 'item-7', 'item-8']}
showMoveAll
showSelectAll
leftTitle="Choices"
rightTitle="Chosen"
/>
)
}A small setup showing card-based composition plus the new form primitives.
import { Button, Card, Input, Textarea } from 'alpha-ui-kit'
import 'alpha-ui-kit/styles.css'
export default function App() {
return (
<Card className="max-w-xl">
<Input label="Name" placeholder="Ada Lovelace" />
<Textarea label="Project Brief" rows={4} />
<Button className="mt-4">Create Project</Button>
</Card>
)
}Live playground: change props from controls and see both output and generated code update instantly.
Live output
import { Button } from 'alpha-ui-kit'
export default function Example() {
return (
<Button variant="contained" color="primary" size="medium">
Continue
</Button>
)
}Production-ready input primitives with labels, helper text, variants, and consistent visual styling.
Use full legal name.
Choose your primary stack.
Choose a planned launch date.
import { Input, Select, Calendar, Textarea, Checkbox, RadioGroup, RadioGroupItem, Switch, Button } from 'alpha-ui-kit'
export default function FormDemo() {
return (
<div className="space-y-4 max-w-md">
<Input label="Name" placeholder="Ada Lovelace" />
<Select label="Framework" defaultValue="react">
<option value="react">React</option>
<option value="next">Next.js</option>
<option value="vue">Vue</option>
</Select>
<Calendar label="Launch Date" />
<Textarea label="Project Notes" rows={3} />
<Checkbox label="Accept terms" description="You can continue after accepting." />
<RadioGroup defaultValue="starter">
<RadioGroupItem value="starter" label="Starter" />
<RadioGroupItem value="pro" label="Pro" />
</RadioGroup>
<Switch label="Enable notifications" defaultChecked />
<Button fullWidth>Submit</Button>
</div>
)
}Alpha UI Input supports all common HTML input types so you can build complete form flows end-to-end.
import { Input } from 'alpha-ui-kit'
export default function InputTypesDemo() {
return (
<div className="grid gap-4 md:grid-cols-2">
<Input type="text" label="Text" placeholder="Enter text" />
<Input type="email" label="Email" placeholder="name@example.com" />
<Input type="password" label="Password" placeholder="Enter password" />
<Input type="number" label="Number" placeholder="42" />
<Input type="search" label="Search" placeholder="Search..." />
<Input type="tel" label="Phone" placeholder="+1 555 0100" />
<Input type="url" label="Website" placeholder="https://example.com" />
<Input type="date" label="Date" />
<Input type="time" label="Time" />
<Input type="datetime-local" label="Datetime" />
<Input type="month" label="Month" />
<Input type="week" label="Week" />
<Input type="color" label="Color" defaultValue="#0ea5e9" />
</div>
)
}Theory and feature map aligned with mature Text Field documentation patterns: props, modes, behavior, and accessibility guidance.
Feature map
Getting started theory
Technical Theory
Unified TextField demos
This value is invalid
Use multiline for longer text
Select rendered from the same TextField wrapper
Badges, alerts, cards, and avatars are available as composable primitives with visual variants.
Composable surface with header/content/footer slots.
Messaging and identity primitives for app states.
Alpha UI Team
Design system maintainers
This alert is dismissible and supports semantic variants.
Container, grid, navbar, and sidebar help structure entire product surfaces with reusable layout primitives.
Dialogs, menus, tabs, accordions, tooltips, and toasts are implemented with variant and state control APIs.
Table, pagination, and stepper primitives cover common workflows for records, navigation, and process progress.
| Invoice | Customer | Status | Total |
|---|---|---|---|
| INV-1201 | Aya Johnson | Paid | $1,240 |
| INV-1202 | Mason Lee | Pending | $420 |
| INV-1203 | Priya Patel | Failed | $980 |
Account setup
Project configuration
Go live
Everything currently available from the package, grouped by purpose.
Action button with variants, sizes, and loading states.
Text field with labels, helper text, and validation states.
Unified input wrapper supporting multiline and select modes.
Multi-line input with the same ergonomic API as Input.
Native select wrapper with size and status variants.
Date input primitive with label, helper text, and validation states.
Accessible checkbox with optional label and description.
Single-select option groups with keyboard-friendly semantics.
Toggle control for boolean settings with labels and descriptions.
Composable surface with header, content, and footer slots.
Small status indicators for labels and states.
Informational callout with title and description primitives.
User identity component with image and fallback support.
Responsive layout wrapper for page-level sections.
Flexible grid utility component for aligned layouts.
Composable top navigation structure with brand and links.
Sidebar container with sectioned navigation items.
Layered dialog for confirmation and focused tasks.
Compact action menu for contextual controls.
Segment content into interactive tabbed views.
Progressive disclosure UI for grouped content.
Hover/focus helper content with placement options.
Transient system feedback via toast notifications.
Semantic data table primitives for structured content.
Page navigation controls for long datasets.
Step-by-step progress indicator with current state.
Move one or more items between lists with selectable transfer actions.