# ziiz > A design-system exploration. The token foundation (a ten-step color ramp, 31 named type roles, eight materials and a prose layer) ships as the npm package `@nafisazizir/ziiz`. The components ship as a shadcn registry served from GitHub. Setup for an app: add the registry to components.json and run `npx shadcn@latest add @ziiz/theme --overwrite`, then `npx shadcn@latest add @ziiz/` for components. The guide below has the details. - Registry URL template: https://raw.githubusercontent.com/nafisazizir/ziiz/main/apps/www/public/r/{name}.json - Agent skill (installs to .agents/skills/ziiz/): `npx shadcn@latest add @ziiz/skill` - Every doc page as one markdown file: https://ziiz.vercel.app/llms-full.txt ## Guide and foundation - [Installation](https://ziiz.vercel.app/installation): Take the design layer as a package and the components from the registry. (markdown: https://ziiz.vercel.app/llms.mdx/installation) - [Colors](https://ziiz.vercel.app/colors): Learn how to work with our color system. (markdown: https://ziiz.vercel.app/llms.mdx/colors) - [Typography](https://ziiz.vercel.app/typography): Rules of typesetting throughout the system. (markdown: https://ziiz.vercel.app/llms.mdx/typography) - [Materials](https://ziiz.vercel.app/materials): Elevation presets combining background, border, shadow, and radius. (markdown: https://ziiz.vercel.app/llms.mdx/materials) - [Prose](https://ziiz.vercel.app/prose): The prose layer: one class that typesets long-form content onto the type roles. (markdown: https://ziiz.vercel.app/llms.mdx/prose) ## Components - [Accordion](https://ziiz.vercel.app/components/accordion): A vertically stacked set of interactive headings that each reveal a section of content. (markdown: https://ziiz.vercel.app/llms.mdx/components/accordion) - [Alert](https://ziiz.vercel.app/components/alert): Displays a callout for user attention. (markdown: https://ziiz.vercel.app/llms.mdx/components/alert) - [Alert Dialog](https://ziiz.vercel.app/components/alert-dialog): A modal dialog that interrupts the user with important content and expects a response. (markdown: https://ziiz.vercel.app/llms.mdx/components/alert-dialog) - [Aspect Ratio](https://ziiz.vercel.app/components/aspect-ratio): Displays content within a desired ratio. (markdown: https://ziiz.vercel.app/llms.mdx/components/aspect-ratio) - [Attachment](https://ziiz.vercel.app/components/attachment): Displays a file or image attachment with media, metadata, upload state, and actions. (markdown: https://ziiz.vercel.app/llms.mdx/components/attachment) - [Avatar](https://ziiz.vercel.app/components/avatar): An image element with a fallback for representing the user. (markdown: https://ziiz.vercel.app/llms.mdx/components/avatar) - [Badge](https://ziiz.vercel.app/components/badge): Displays a badge or a component that looks like a badge. (markdown: https://ziiz.vercel.app/llms.mdx/components/badge) - [Breadcrumb](https://ziiz.vercel.app/components/breadcrumb): Displays the path to the current resource using a hierarchy of links. (markdown: https://ziiz.vercel.app/llms.mdx/components/breadcrumb) - [Bubble](https://ziiz.vercel.app/components/bubble): Displays conversational content in a message bubble. Supports variants, alignment, grouping, reactions, and collapsible content. (markdown: https://ziiz.vercel.app/llms.mdx/components/bubble) - [Button](https://ziiz.vercel.app/components/button): Displays a button or a component that looks like a button. (markdown: https://ziiz.vercel.app/llms.mdx/components/button) - [Button Group](https://ziiz.vercel.app/components/button-group): A container that groups related buttons together with consistent styling. (markdown: https://ziiz.vercel.app/llms.mdx/components/button-group) - [Calendar](https://ziiz.vercel.app/components/calendar): A calendar component that allows users to select a date or a range of dates. (markdown: https://ziiz.vercel.app/llms.mdx/components/calendar) - [Card](https://ziiz.vercel.app/components/card): Displays a card with header, content, and footer. (markdown: https://ziiz.vercel.app/llms.mdx/components/card) - [Carousel](https://ziiz.vercel.app/components/carousel): A carousel with motion and swipe built using Embla. (markdown: https://ziiz.vercel.app/llms.mdx/components/carousel) - [Chart](https://ziiz.vercel.app/components/chart): Beautiful charts. Built using Recharts. Copy and paste into your apps. (markdown: https://ziiz.vercel.app/llms.mdx/components/chart) - [Checkbox](https://ziiz.vercel.app/components/checkbox): A control that allows the user to toggle between checked and not checked. (markdown: https://ziiz.vercel.app/llms.mdx/components/checkbox) - [Collapsible](https://ziiz.vercel.app/components/collapsible): An interactive component which expands/collapses a panel. (markdown: https://ziiz.vercel.app/llms.mdx/components/collapsible) - [Combobox](https://ziiz.vercel.app/components/combobox): Autocomplete input with a list of suggestions. (markdown: https://ziiz.vercel.app/llms.mdx/components/combobox) - [Command](https://ziiz.vercel.app/components/command): Command menu for search and quick actions. (markdown: https://ziiz.vercel.app/llms.mdx/components/command) - [Context Menu](https://ziiz.vercel.app/components/context-menu): Displays a menu of actions triggered by a right click. (markdown: https://ziiz.vercel.app/llms.mdx/components/context-menu) - [Dialog](https://ziiz.vercel.app/components/dialog): A window overlaid on either the primary window or another dialog window, rendering the content underneath inert. (markdown: https://ziiz.vercel.app/llms.mdx/components/dialog) - [Direction](https://ziiz.vercel.app/components/direction): A provider component that sets the text direction for your application. (markdown: https://ziiz.vercel.app/llms.mdx/components/direction) - [Drawer](https://ziiz.vercel.app/components/drawer): A drawer component for React. (markdown: https://ziiz.vercel.app/llms.mdx/components/drawer) - [Dropdown Menu](https://ziiz.vercel.app/components/dropdown-menu): Displays a menu to the user, such as a set of actions or functions, triggered by a button. (markdown: https://ziiz.vercel.app/llms.mdx/components/dropdown-menu) - [Empty](https://ziiz.vercel.app/components/empty): Use the Empty component to display an empty state. (markdown: https://ziiz.vercel.app/llms.mdx/components/empty) - [Field](https://ziiz.vercel.app/components/field): Combine labels, controls, and help text to compose accessible form fields and grouped inputs. (markdown: https://ziiz.vercel.app/llms.mdx/components/field) - [Hover Card](https://ziiz.vercel.app/components/hover-card): For sighted users to preview content available behind a link. (markdown: https://ziiz.vercel.app/llms.mdx/components/hover-card) - [Input](https://ziiz.vercel.app/components/input): A text input component for forms and user data entry with built-in styling and accessibility features. (markdown: https://ziiz.vercel.app/llms.mdx/components/input) - [Input Group](https://ziiz.vercel.app/components/input-group): Add addons, buttons, and helper content to inputs. (markdown: https://ziiz.vercel.app/llms.mdx/components/input-group) - [Input OTP](https://ziiz.vercel.app/components/input-otp): Accessible one-time password component with copy-paste functionality. (markdown: https://ziiz.vercel.app/llms.mdx/components/input-otp) - [Item](https://ziiz.vercel.app/components/item): A versatile component for displaying content with media, title, description, and actions. (markdown: https://ziiz.vercel.app/llms.mdx/components/item) - [Kbd](https://ziiz.vercel.app/components/kbd): Used to display textual user input from keyboard. (markdown: https://ziiz.vercel.app/llms.mdx/components/kbd) - [Label](https://ziiz.vercel.app/components/label): Renders an accessible label associated with controls. (markdown: https://ziiz.vercel.app/llms.mdx/components/label) - [Marker](https://ziiz.vercel.app/components/marker): Displays an inline status, system note, bordered row, or labeled separator in a conversation. (markdown: https://ziiz.vercel.app/llms.mdx/components/marker) - [Menubar](https://ziiz.vercel.app/components/menubar): A visually persistent menu common in desktop applications that provides quick access to a consistent set of commands. (markdown: https://ziiz.vercel.app/llms.mdx/components/menubar) - [Message](https://ziiz.vercel.app/components/message): Displays a message in a conversation, with optional avatar, header, footer, and alignment. (markdown: https://ziiz.vercel.app/llms.mdx/components/message) - [Message Scroller](https://ziiz.vercel.app/components/message-scroller): A chat scroll container that anchors turns, opens saved transcripts, follows streamed responses, loads history without jumping, and jumps to any message. (markdown: https://ziiz.vercel.app/llms.mdx/components/message-scroller) - [Native Select](https://ziiz.vercel.app/components/native-select): A styled native HTML select element with consistent design system integration. (markdown: https://ziiz.vercel.app/llms.mdx/components/native-select) - [Nav](https://ziiz.vercel.app/components/nav): Site navigation with grouped links and text-only states, for docs and marketing rails. (markdown: https://ziiz.vercel.app/llms.mdx/components/nav) - [Navigation Menu](https://ziiz.vercel.app/components/navigation-menu): A collection of links for navigating websites. (markdown: https://ziiz.vercel.app/llms.mdx/components/navigation-menu) - [Pagination](https://ziiz.vercel.app/components/pagination): Pagination with page navigation, next and previous links. (markdown: https://ziiz.vercel.app/llms.mdx/components/pagination) - [Popover](https://ziiz.vercel.app/components/popover): Displays rich content in a portal, triggered by a button. (markdown: https://ziiz.vercel.app/llms.mdx/components/popover) - [Progress](https://ziiz.vercel.app/components/progress): Displays an indicator showing the completion progress of a task, typically displayed as a progress bar. (markdown: https://ziiz.vercel.app/llms.mdx/components/progress) - [Questionnaire](https://ziiz.vercel.app/components/questionnaire): A multi-step questionnaire with single-choice, multiple-choice, freeform, and skippable questions. (markdown: https://ziiz.vercel.app/llms.mdx/components/questionnaire) - [Radio Group](https://ziiz.vercel.app/components/radio-group): A set of checkable buttons (known as radio buttons) where no more than one of the buttons can be checked at a time. (markdown: https://ziiz.vercel.app/llms.mdx/components/radio-group) - [Resizable](https://ziiz.vercel.app/components/resizable): Accessible resizable panel groups and layouts with keyboard support. (markdown: https://ziiz.vercel.app/llms.mdx/components/resizable) - [Scroll Area](https://ziiz.vercel.app/components/scroll-area): Augments native scroll functionality for custom, cross-browser styling. (markdown: https://ziiz.vercel.app/llms.mdx/components/scroll-area) - [Select](https://ziiz.vercel.app/components/select): Displays a list of options for the user to pick from, triggered by a button. (markdown: https://ziiz.vercel.app/llms.mdx/components/select) - [Separator](https://ziiz.vercel.app/components/separator): Visually or semantically separates content. (markdown: https://ziiz.vercel.app/llms.mdx/components/separator) - [Sheet](https://ziiz.vercel.app/components/sheet): Extends the Dialog component to display content that complements the main content of the screen. (markdown: https://ziiz.vercel.app/llms.mdx/components/sheet) - [Sidebar](https://ziiz.vercel.app/components/sidebar): A composable, themeable and customizable sidebar component. (markdown: https://ziiz.vercel.app/llms.mdx/components/sidebar) - [Skeleton](https://ziiz.vercel.app/components/skeleton): Use to show a placeholder while content is loading. (markdown: https://ziiz.vercel.app/llms.mdx/components/skeleton) - [Slider](https://ziiz.vercel.app/components/slider): An input where the user selects a value from within a given range. (markdown: https://ziiz.vercel.app/llms.mdx/components/slider) - [Sonner](https://ziiz.vercel.app/components/sonner): An opinionated toast component, wired to the active theme. (markdown: https://ziiz.vercel.app/llms.mdx/components/sonner) - [Spinner](https://ziiz.vercel.app/components/spinner): An indicator that can be used to show a loading state. (markdown: https://ziiz.vercel.app/llms.mdx/components/spinner) - [Switch](https://ziiz.vercel.app/components/switch): A control that allows the user to toggle between checked and not checked. (markdown: https://ziiz.vercel.app/llms.mdx/components/switch) - [Table](https://ziiz.vercel.app/components/table): A responsive table component. (markdown: https://ziiz.vercel.app/llms.mdx/components/table) - [Tabs](https://ziiz.vercel.app/components/tabs): A set of layered sections of content, known as tab panels, that are displayed one at a time. (markdown: https://ziiz.vercel.app/llms.mdx/components/tabs) - [Textarea](https://ziiz.vercel.app/components/textarea): Displays a form textarea or a component that looks like a textarea. (markdown: https://ziiz.vercel.app/llms.mdx/components/textarea) - [Toast](https://ziiz.vercel.app/components/toast): A succinct message that is displayed temporarily. (markdown: https://ziiz.vercel.app/llms.mdx/components/toast) - [Toggle](https://ziiz.vercel.app/components/toggle): A two-state button that can be either on or off. (markdown: https://ziiz.vercel.app/llms.mdx/components/toggle) - [Toggle Group](https://ziiz.vercel.app/components/toggle-group): A set of two-state buttons that can be toggled on or off. (markdown: https://ziiz.vercel.app/llms.mdx/components/toggle-group) - [Tooltip](https://ziiz.vercel.app/components/tooltip): A popup that displays information related to an element when the element receives keyboard focus or the mouse hovers over it. (markdown: https://ziiz.vercel.app/llms.mdx/components/tooltip) ## Blog - [Introducing ziiz](https://ziiz.vercel.app/blog/introducing-ziiz): A design layer other apps can consume, and the playground that dogfoods it. (markdown: https://ziiz.vercel.app/llms.mdx/blog/introducing-ziiz) - [Prose in one stylesheet](https://ziiz.vercel.app/blog/prose-in-one-stylesheet): The typeset class, and why long-form content needs no components. (markdown: https://ziiz.vercel.app/llms.mdx/blog/prose-in-one-stylesheet) - [Fixed pixels](https://ziiz.vercel.app/blog/fixed-pixels): Why the 31 type roles are set in pixels, and what that buys. (markdown: https://ziiz.vercel.app/llms.mdx/blog/fixed-pixels)