# oks-ui

> oks-ui is a strict-TypeScript React component library with a CSS-variable
> design system. It has zero runtime dependencies beyond React, needs no theme
> provider and no configuration, and is accessible by default (keyboard support,
> visible focus, ARIA roles, reduced-motion). MIT licensed and free. Install with
> `npm install oks-ui`, then `import "oks-ui/styles.css"` once.

## Docs

- [Getting started](https://www.oks-ui.com/docs/): what oks-ui is and the tradeoffs it makes.
- [Installation](https://www.oks-ui.com/docs/installation/): install the package, import styles once, use a component. No provider, no config.
- [Theming](https://www.oks-ui.com/docs/theming/): every color, space, radius, and shadow is an `--oks-*` CSS custom property. Override tokens from your own CSS; point semantic roles (primary/secondary/danger/…) at any palette.
- [Use with AI](https://www.oks-ui.com/docs/ai/): how to point an AI assistant at this file and llms-full.txt to build a UI with oks-ui.

## Components

- [All components](https://www.oks-ui.com/components/): 55 components across Actions, Feedback, Navigation, Data Display, Data Visualization, Layout & Display, Forms, and Editors. Each has an interactive props playground at `https://www.oks-ui.com/components/<slug>/`.
- Full list with one-line descriptions: [llms-full.txt](https://www.oks-ui.com/llms-full.txt).

## Patterns

- [Patterns](https://www.oks-ui.com/patterns/): 20 full product screens assembled from oks-ui, each with a live preview and the complete crawlable source.

## Templates

- [Templates](https://www.oks-ui.com/templates/): full applications built entirely on oks-ui — hosted and open-source. Open one to click through the real product; read its source to see how the pieces fit.

## Blog

- [Blog](https://www.oks-ui.com/blog/): tutorials and engineering notes — [RSS feed](https://www.oks-ui.com/blog/feed.xml).
  - [Dependency-free drag-and-drop: inside the oks-ui Board](https://www.oks-ui.com/blog/dependency-free-drag-and-drop-inside-board/)
  - [Dark mode with no flash: the data-theme init pattern](https://www.oks-ui.com/blog/dark-mode-with-no-flash/)
  - [Build a sortable, selectable data table](https://www.oks-ui.com/blog/build-a-sortable-selectable-data-table/)
  - [Theme oks-ui to your brand in 10 minutes](https://www.oks-ui.com/blog/theme-oks-ui-to-your-brand-in-10-minutes/)

## Answers

- [FAQ](https://www.oks-ui.com/faq/): 13 questions — licensing, Next.js / React Server Components support, theming, bundle size, accessibility, versioning.

## Key facts

- Package: `oks-ui` on npm — https://www.npmjs.com/package/oks-ui
- License: MIT (free for commercial and personal use)
- Dependencies: none at runtime beyond `react` / `react-dom`
- Requires: React 18 or newer; works with the Next.js App Router
- Styling: import `oks-ui/styles.css` once; theme via `--oks-*` CSS variables
- Import: named exports, e.g. `import { Button, Modal, Table } from "oks-ui"`