https://github.com/idouglasd/solo-ui
A modern React design system built on Base UI and CVA. Headless, composable, fully typed, with design tokens and Storybook documentation. Published as @solo-ui packages.
https://github.com/idouglasd/solo-ui
base-ui biomejs changeset design-system headless react storybook tsup turborepo
Last synced: 23 days ago
JSON representation
A modern React design system built on Base UI and CVA. Headless, composable, fully typed, with design tokens and Storybook documentation. Published as @solo-ui packages.
- Host: GitHub
- URL: https://github.com/idouglasd/solo-ui
- Owner: iDouglasD
- License: mit
- Created: 2026-03-24T18:51:47.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-04-03T00:57:31.000Z (24 days ago)
- Last Synced: 2026-04-03T10:48:09.496Z (24 days ago)
- Topics: base-ui, biomejs, changeset, design-system, headless, react, storybook, tsup, turborepo
- Language: TypeScript
- Homepage:
- Size: 253 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# solo-ui
React design system built with CVA, Tailwind CSS v4, and TypeScript.
## Packages
| Package | Description |
|---------|-------------|
| `@solo-ds/ui` | React component library |
| `@solo-ds/tokens` | Design tokens (TS + CSS variables) |
| `@solo-ds/ts-config` | Shared TypeScript configs |
| `@solo-ds/lint-config` | Shared Biome configs |
## Usage
### Installation
```bash
pnpm add @solo-ds/ui @solo-ds/tokens
```
### Setup
Import the styles in your app entry point:
```css
@import '@solo-ds/tokens/styles/tokens.css';
@import '@solo-ds/ui/styles.css';
```
### Components
```tsx
import { Button } from '@solo-ds/ui'
export function App() {
return Click me
}
```
### Tokens (TypeScript)
```ts
import { colors } from '@solo-ds/tokens'
```
## Development
**Requirements:** Node.js 18+, pnpm 10.7+
```bash
pnpm install # install dependencies
pnpm dev # Storybook dev server
pnpm build # build all packages
pnpm lint # lint all packages
pnpm format # format all packages
```
## Publishing
Releases use [Changesets](https://github.com/changesets/changesets) with fixed versioning — all public packages version together.
```bash
# 1. Document your changes
pnpm changeset
# 2. Bump versions
pnpm version-packages
# 3. Publish to NPM
pnpm release
```
## License
MIT