Aidos UI
This is a React design system library with many utilities and zero dependencies. It was built with the aim to be simple, lightweight, and beautiful. The components below are the real library, composed into the kinds of screens applications actually need.
A small system with a strong point of view
Accessible controls, composable layout primitives, atmospheric surfaces, and no runtime styling dependency.
A complete interface
Primitives stay useful on their own, but they are designed to become more than the sum of their parts. This workspace combines surfaces, navigation, identity, progress, inputs, and actions without application-specific CSS.
- Review visual languageCompleted by Maya
- Prepare release notesDue this afternoon
- Validate package outputWaiting on review
Controls that compose
Inputs and actions share spacing, focus, typography, and interaction behavior, so small forms feel coherent without a layer of application-specific CSS.
- Keyboard navigation
- Light and dark themes
- Responsive primitives
Atmosphere with restraint
Materials add character without changing component structure. They adapt to both themes and can be reserved for navigation, focal cards, and application chrome.
Mobile
The compact interface combines an application header, content hierarchy, status, actions, and the real keyboard-navigable TabBar.
- Coastal surveyToday at 14:30 · North trail
Desktop
The same hierarchy becomes a persistent master-detail workspace. NavigationSplitView owns the responsive geometry while the sidebar, toolbar, content, and context panel remain ordinary composable surfaces.
- 75%4 milestones remaining
- Validate package outputWaiting for a second review
- Finalize field notesDue today at 16:00
Explore the responsive shell and its API on the NavigationSplitView documentation.
Installation
This library can be installed through npm:
npm install --save aidos-ui
How to use
Add the Providers component somewhere near your application root:
import { Providers, darkTheme, lightTheme } from "aidos-ui";
<Providers themes={{ light: lightTheme, dark: darkTheme }}>
<App />
</Providers>;
If the application is running in Next.js, add JSServerStyles to the document <Head /> so JSS also works during server rendering:
import { JSServerStyles } from "aidos-ui";
<Head>
<JSServerStyles />
</Head>;
Then start with a component or copy one of the compositions above. The library is intentionally opinionated, but every primitive is designed to extend cleanly.