# Tray UI
> A design system in plain HTML and CSS: 108 components, 64 blocks, 118 icons and 10 themes, with typed React components and 58 chart examples on Recharts. Version 0.2.0, MIT licence, by Vladyslav Korzh.
Link three files and write HTML with `tray-` classes; behaviours attach with `data-tray`, and nothing needs a build step:
```html
```
Every page of https://trayui.com is also Markdown: add `.md` to its address. [llms-full.txt](https://trayui.com/llms-full.txt) holds the whole system in one file.
- From npm: `npm install trayui` for the three files, `npm install trayui-react` for React (it needs `react` and `react-dom`, and `recharts` for the charts).
- Counter and Perly Farm, the brands in the examples, are invented, and so is every name and figure in them.
- Use only classes that exist; where a layout needs a value no class gives, use a token (`var(--space-6)`), never a literal colour or size.
## Docs
- [Introduction](https://trayui.com/docs.md): Tray UI is a design system for products and the pages around them, written in plain HTML and CSS, with one small script for behaviour.
- [Installation](https://trayui.com/docs/installation.md): Three files and a font. Link them from a CDN or copy them into your project, then write HTML. There is nothing to build.
- [Theming](https://trayui.com/docs/theming.md): Every colour, size, radius and space in the stylesheet is a custom property from tokens.css. Change a token and everything that uses it follows.
- [Themes](https://trayui.com/docs/themes.md): 10 themes to choose from, and a maker for your own: four colours in, a whole theme out.
- [React](https://trayui.com/docs/react.md): The same 108 components as typed React components, over the same stylesheet and the same behaviours.
- [Tailwind and Figma](https://trayui.com/docs/tailwind-figma.md): The tokens of the system for two more tools: a theme for Tailwind CSS, and variables for Figma with a mode for each theme.
- [Coming from Tailwind](https://trayui.com/docs/from-tailwind.md): How Tailwind habits map to Tray UI, a design system in plain HTML and CSS: what differs, how to move a screen across, and when to keep Tailwind.
- [For AI agents](https://trayui.com/docs/agents.md): The system is written to be read by an agent as well as by a person: short rules, exact names, and markup that can be copied.
- [Changelog](https://trayui.com/docs/changelog.md): What changed in each version of Tray UI, the design system in plain HTML and CSS: its components, blocks, themes and tools, newest first.
- [Colours](https://trayui.com/docs/colours.md): The 60 colour tokens in the Light and the Dark theme, and what each is for.
- [Typography](https://trayui.com/docs/typography.md): The type styles of the system: one family, Onest, in two voices, and the size, line height and weight of every class.
- [Space and shape](https://trayui.com/docs/space-and-shape.md): Space, corners, sizes, the one shadow and the rest of the scale: each a token, with its value and what it is for.
- [Icons](https://trayui.com/docs/icons.md): 118 icons from Lucide built in, ready to copy, and how to use any other.
## Guides
- [The brand book](https://trayui.com/docs/brand-book.md): The rules of the system in one page: content, colour, type, shape, layout, motion and icons.
- [Grounds and nesting](https://trayui.com/docs/grounds.md): Depth in this system is fill, and fill alternates. A component never needs to be told its colours; it reads them from the ground it sits on.
- [Styles and behaviour](https://trayui.com/docs/behaviour.md): The system ships as three files and needs no framework and no build step.
- [Accessibility](https://trayui.com/docs/accessibility.md): The system is built to pass WCAG 2.2 AA in every theme. These are the rules that keep it there.
- [Page layouts](https://trayui.com/docs/layouts.md): Blocks are whole screens, so they need a frame as well as components. There are two frames.
## Components
- [All 108 components](https://trayui.com/components.md): each with the sentence that says what it is for
- [Button](https://trayui.com/components/button.md)
- [Button Group](https://trayui.com/components/button-group.md)
- [Toggle](https://trayui.com/components/toggle.md)
- [Toggle Group](https://trayui.com/components/toggle-group.md)
- [Calendar](https://trayui.com/components/calendar.md)
- [Checkbox](https://trayui.com/components/checkbox.md)
- [Combobox](https://trayui.com/components/combobox.md)
- [Date Picker](https://trayui.com/components/date-picker.md)
- [Field](https://trayui.com/components/field.md)
- [File Upload](https://trayui.com/components/file-upload.md)
- [Input](https://trayui.com/components/input.md)
- [Input Group](https://trayui.com/components/input-group.md)
- [Input OTP](https://trayui.com/components/input-otp.md)
- [Label](https://trayui.com/components/label.md)
- [Native Select](https://trayui.com/components/native-select.md)
- [Radio Group](https://trayui.com/components/radio-group.md)
- [Select](https://trayui.com/components/select.md)
- [Slider](https://trayui.com/components/slider.md)
- [Switch](https://trayui.com/components/switch.md)
- [Tag Input](https://trayui.com/components/tag-input.md)
- [Textarea](https://trayui.com/components/textarea.md)
- [Breadcrumb](https://trayui.com/components/breadcrumb.md)
- [Command](https://trayui.com/components/command.md)
- [Menubar](https://trayui.com/components/menubar.md)
- [Navigation Menu](https://trayui.com/components/navigation-menu.md)
- [Pagination](https://trayui.com/components/pagination.md)
- [Sidebar](https://trayui.com/components/sidebar.md)
- [Stepper](https://trayui.com/components/stepper.md)
- [Tabs](https://trayui.com/components/tabs.md)
- [Alert Dialog](https://trayui.com/components/alert-dialog.md)
- [Context Menu](https://trayui.com/components/context-menu.md)
- [Dialog](https://trayui.com/components/dialog.md)
- [Drawer](https://trayui.com/components/drawer.md)
- [Dropdown Menu](https://trayui.com/components/dropdown-menu.md)
- [Hover Card](https://trayui.com/components/hover-card.md)
- [Popover](https://trayui.com/components/popover.md)
- [Sheet](https://trayui.com/components/sheet.md)
- [Tooltip](https://trayui.com/components/tooltip.md)
- [Alert](https://trayui.com/components/alert.md)
- [Banner](https://trayui.com/components/banner.md)
- [Empty](https://trayui.com/components/empty.md)
- [Progress](https://trayui.com/components/progress.md)
- [Skeleton](https://trayui.com/components/skeleton.md)
- [Spinner](https://trayui.com/components/spinner.md)
- [Toast](https://trayui.com/components/toast.md)
- [Chart](https://trayui.com/components/chart.md)
- [Data Table](https://trayui.com/components/data-table.md)
- [Table](https://trayui.com/components/table.md)
- [Aspect Ratio](https://trayui.com/components/aspect-ratio.md)
- [Carousel](https://trayui.com/components/carousel.md)
- [Direction](https://trayui.com/components/direction.md)
- [Resizable](https://trayui.com/components/resizable.md)
- [Scroll Area](https://trayui.com/components/scroll-area.md)
- [Separator](https://trayui.com/components/separator.md)
- [Accordion](https://trayui.com/components/accordion.md)
- [Avatar](https://trayui.com/components/avatar.md)
- [Badge](https://trayui.com/components/badge.md)
- [Card](https://trayui.com/components/card.md)
- [Collapsible](https://trayui.com/components/collapsible.md)
- [Description List](https://trayui.com/components/description-list.md)
- [Item](https://trayui.com/components/item.md)
- [Kbd](https://trayui.com/components/kbd.md)
- [Lightbox](https://trayui.com/components/lightbox.md)
- [Typography](https://trayui.com/components/typography.md)
- [Video Player](https://trayui.com/components/video-player.md)
- [Attachment](https://trayui.com/components/attachment.md)
- [Bubble](https://trayui.com/components/bubble.md)
- [Code Block](https://trayui.com/components/code-block.md)
- [Marker](https://trayui.com/components/marker.md)
- [Message](https://trayui.com/components/message.md)
- [Message Scroller](https://trayui.com/components/message-scroller.md)
- [Questionnaire](https://trayui.com/components/questionnaire.md)
- [Trace](https://trayui.com/components/trace.md)
- [App Shell](https://trayui.com/components/app-shell.md)
- [Filter Bar](https://trayui.com/components/filter-bar.md)
- [Notification Center](https://trayui.com/components/notification-center.md)
- [Page Header](https://trayui.com/components/page-header.md)
- [Top Bar](https://trayui.com/components/top-bar.md)
- [User Menu](https://trayui.com/components/user-menu.md)
- [Workspace Switcher](https://trayui.com/components/workspace-switcher.md)
- [Activity Feed](https://trayui.com/components/activity-feed.md)
- [Stat Card](https://trayui.com/components/stat-card.md)
- [Uptime](https://trayui.com/components/uptime.md)
- [Usage Meter](https://trayui.com/components/usage-meter.md)
- [Billing Summary](https://trayui.com/components/billing-summary.md)
- [Checkout Summary](https://trayui.com/components/checkout-summary.md)
- [Invoice List](https://trayui.com/components/invoice-list.md)
- [Payment Method](https://trayui.com/components/payment-method.md)
- [Plan Comparison](https://trayui.com/components/plan-comparison.md)
- [Pricing Table](https://trayui.com/components/pricing-table.md)
- [Upgrade Prompt](https://trayui.com/components/upgrade-prompt.md)
- [API Keys](https://trayui.com/components/api-keys.md)
- [Auth Form](https://trayui.com/components/auth-form.md)
- [Integration Card](https://trayui.com/components/integration-card.md)
- [Invite Form](https://trayui.com/components/invite-form.md)
- [Notification Preferences](https://trayui.com/components/notification-preferences.md)
- [Settings Section](https://trayui.com/components/settings-section.md)
- [Team Members](https://trayui.com/components/team-members.md)
- [Changelog](https://trayui.com/components/changelog.md)
- [Cookie Consent](https://trayui.com/components/cookie-consent.md)
- [Feedback Widget](https://trayui.com/components/feedback-widget.md)
- [Onboarding Checklist](https://trayui.com/components/onboarding-checklist.md)
- [Tour](https://trayui.com/components/tour.md)
- [Call to Action](https://trayui.com/components/call-to-action.md)
- [Feature Grid](https://trayui.com/components/feature-grid.md)
- [Footer](https://trayui.com/components/footer.md)
- [Hero](https://trayui.com/components/hero.md)
- [Testimonial](https://trayui.com/components/testimonial.md)
## Blocks
Whole screens to copy, each one HTML file.
- [All 64 blocks](https://trayui.com/blocks.md): every block with a sentence on what it holds
- [Sign-in and sign-up pages](https://trayui.com/blocks/login.md)
- [Sidebars](https://trayui.com/blocks/sidebar.md)
## Charts
- [Using the charts](https://trayui.com/charts/usage.md): In React, charts are drawn by Recharts. The package adds the frame, the colours, the tooltip, the key and the table of figures of this system.
- [Area charts](https://trayui.com/charts/area.md): A volume over time: a 2px line over a quiet fill. One series is ink; several take the data colours and a key.
- [Bar charts](https://trayui.com/charts/bar.md): Separate periods, rankings and parts of a whole: bars 24px wide at most, with 4px corners at the end that carries the value.
- [Line charts](https://trayui.com/charts/line.md): A trend: 2px lines, no dots unless each reading matters. Never a second value axis.
- [Pie charts](https://trayui.com/charts/pie.md): Parts of a whole at one moment, five at most, clockwise from the top and set apart by a gap.
- [Radar charts](https://trayui.com/charts/radar.md): Several measures of one thing, on a hairline web. Two series at most.
- [Radial charts](https://trayui.com/charts/radial.md): A single share or score as a ring on a track, with its figure in the middle.
- [Tooltips](https://trayui.com/charts/tooltip.md): What the tooltip can say. Each is shown open; point at another bar to move it.
- [The Chart component](https://trayui.com/charts/chart-component.md): One component for the six usual forms: give it labels and series, and it composes the chart, its key and its table of figures.
## Optional
- [llms-full.txt](https://trayui.com/llms-full.txt): the rules, the guides and the guidelines of every component in one file
- [trayui-0.2.0.zip](https://trayui.com/trayui-0.2.0.zip): the three files, the font and the 64 blocks