# Tanrei > Tanrei is one design system for Web, SwiftUI, Jetpack Compose, Flutter and React Native. Its sources of truth are design tokens in the DTCG format and a platform-neutral spec for each component: each platform's tokens, the documentation's tables and these files are generated from them, and each platform implements the specs. This index follows the default design system, Tanrei (`tanrei`): the components listed under "Components in Tanrei" are the ones it ships. A component it does not ship is listed apart, with what to use instead; it is only in the systems named there. Each other system has an index of its own (under "Design systems"). On the web the default system's tokens are `@tanrei/web/tokens.css`. Each link is the page as Markdown; the sections follow the site's sidebar. A component's page holds its own text, then what the component's spec says — its props, events, slots, states, accessibility, every requirement with its id, its tokens, and its name and status on each platform. The version is `0.1.0-next.0`, a 0.x prerelease: names and APIs may change between releases. ## Getting started - [Getting started](https://tanrei.chnotchy.com/getting-started.md): What Tanrei ships, how the pieces fit together, and where to start on your platform. - [Web](https://tanrei.chnotchy.com/getting-started/web.md): Use Tanrei's CSS tokens and Web Components in any web project. - [React](https://tanrei.chnotchy.com/getting-started/react.md): Typed React components generated from Tanrei's Web Components. - [SwiftUI](https://tanrei.chnotchy.com/getting-started/swiftui.md): Add Tanrei to an iOS or macOS app with Swift Package Manager. - [Jetpack Compose](https://tanrei.chnotchy.com/getting-started/compose.md): Add Tanrei to an Android app built with Jetpack Compose. - [Flutter](https://tanrei.chnotchy.com/getting-started/flutter.md): Add Tanrei to a Flutter app. - [React Native](https://tanrei.chnotchy.com/getting-started/react-native.md): Add Tanrei to a React Native app. - [Presets](https://tanrei.chnotchy.com/getting-started/presets.md): Draw your product as one of the shipped presets — one stylesheet and one attribute, the fonts it asks for, the components it has — or take a single preset component into a system of your own. - [Your own design system](https://tanrei.chnotchy.com/getting-started/your-design-system.md): Keep one layer file in your product. One command writes tokens and code for every platform you ship, in one pull request. - [Using Tanrei with AI agents](https://tanrei.chnotchy.com/getting-started/ai-agents.md): Connect Tanrei's MCP server, give a coding agent your product's UI rules in AGENTS.md, and keep it to the components and values of the default system. ## Foundations - [Brand](https://tanrei.chnotchy.com/foundations/brand.md): Tanrei's name, its two marks and how to use them, and the character the system is drawn with. - [Design tokens](https://tanrei.chnotchy.com/foundations/design-tokens.md): Four tiers from a few dials, resolved per context, written once in the DTCG format and generated for every platform. - [Design systems and customization](https://tanrei.chnotchy.com/foundations/design-systems.md): One vocabulary, many design systems. Change a dial, declare a palette, re-point a token — and every platform follows in one commit. - [Theme Studio](https://tanrei.chnotchy.com/foundations/theme-studio.md): Move a few controls, watch real components follow, and export a valid design-system layer you can build for every platform. - [Color](https://tanrei.chnotchy.com/foundations/color.md): Color roles, the monochrome primary, the single accent, and how every scheme is generated and checked. - [Typography](https://tanrei.chnotchy.com/foundations/typography.md): Sixteen text styles named by level — one display, six headings, three body sizes, labels, code, an eyebrow — set in Inter, with emphasis as a weight step rather than a role. - [Icons](https://tanrei.chnotchy.com/foundations/icons.md): One icon set per design system, one weight, and one rule — outlined when unselected, filled when selected. - [Shape](https://tanrei.chnotchy.com/foundations/shape.md): A small-radius corner scale, with 6px as the default for controls, and one number for how a corner curves. - [Elevation](https://tanrei.chnotchy.com/foundations/elevation.md): Six levels of z-order, drawn as a hairline ring plus a very soft shadow, with no surface tint. - [Motion](https://tanrei.chnotchy.com/foundations/motion.md): Durations chosen by what moves, four easing curves, one way for every surface to appear, nothing that moves as the page loads, and reduced motion from the person's setting or the app's own. - [Interaction states](https://tanrei.chnotchy.com/foundations/states.md): State layers, the gap-then-ring focus indicator, and how disabled is drawn. - [Behaviour](https://tanrei.chnotchy.com/foundations/behaviour.md): Two choices of kind — how a press is answered and how keyboard focus looks — that a design system sets like any other token. - [Layout](https://tanrei.chnotchy.com/foundations/layout.md): Window size classes, the spacing scale and how layouts adapt between them. - [Size and density](https://tanrei.chnotchy.com/foundations/size-and-density.md): A ladder of five heights for the sizes of controls, the least size anything pressable is drawn at, and a size a container passes to what it holds. - [Accessibility](https://tanrei.chnotchy.com/foundations/accessibility.md): The accessibility requirements Tanrei builds into tokens and component specs, and the checks that enforce them. - [Words](https://tanrei.chnotchy.com/foundations/words.md): A component has no words of its own. Every label, name and message it draws or says is your product's — given on the component, once for the whole product, or taken from the English word pack you import. ## Token reference - [Color tokens](https://tanrei.chnotchy.com/tokens/color.md): Every system color role with its resolved light and dark value at each contrast level. - [Typescale tokens](https://tanrei.chnotchy.com/tokens/typescale.md): Every text style by level with a live specimen, its resolved metrics and the weight it takes when emphasized. - [Shape tokens](https://tanrei.chnotchy.com/tokens/shape.md): The corner radius scale, and the one number that says how a corner curves. - [Elevation tokens](https://tanrei.chnotchy.com/tokens/elevation.md): The six elevation levels as composite shadow values for light and dark. - [Motion tokens](https://tanrei.chnotchy.com/tokens/motion.md): Durations by role, the duration scale, easing curves by role, where a surface appears from, and springs. - [State tokens](https://tanrei.chnotchy.com/tokens/state.md): State layer and disabled opacities. - [Space and measure tokens](https://tanrei.chnotchy.com/tokens/space.md): The spacing scale, minimum targets, icon sizes, border widths and focus ring measurements. ## Components in Tanrei - [Button](https://tanrei.chnotchy.com/components/button.md): Lets people take an action, switch something on and off, go to a destination, or send or clear the form it stands in, with one tap or click — named by a label, an icon, or both. - [Main action button](https://tanrei.chnotchy.com/components/main-action-button.md): Performs the single most important action of a screen on a raised container that floats above the content, showing its icon and its written name, or collapsing to its icon alone. - [Button group](https://tanrei.chnotchy.com/components/button-group.md): Lays out a few related Buttons in a row or a column, spaced apart or joined into one shape by a divider or a gap, places the completing and the backing-out actions where people expect them, and names the Buttons as a group. - [Button with menu](https://tanrei.chnotchy.com/components/button-with-menu.md): Performs a main action with one press, and reveals more options for it in a menu from a second button joined to it. - [Toolbar](https://tanrei.chnotchy.com/components/toolbar.md): Holds a set of related controls — actions, toggles, a choice among a few tools, a menu, a select or a number — as one Tab stop: inline where its content needs it (an editor's formatting bar, a table's actions, a row of filters), docked across an edge of the screen or of a region, or floating over the content. - [Copy button](https://tanrei.chnotchy.com/components/copy-button.md): Copies a given text to the clipboard with one press and confirms it — its glyph becomes a check for a moment and assistive technology is told — or says that it could not; it is drawn by Button and, unless asked to fit its words, never moves the layout. - [Checkbox](https://tanrei.chnotchy.com/components/checkbox.md): Lets people turn one independent choice on or off, show a parent choice that is only partly on, and mark a required choice left unmade. - [Radio button](https://tanrei.chnotchy.com/components/radio-button.md): Lets people choose exactly one option from a small group shown all at once. - [Switch](https://tanrei.chnotchy.com/components/switch.md): Turns one setting on or off, taking effect at once, with a handle that slides along a track and follows a finger dragged along it. - [Chip](https://tanrei.chnotchy.com/components/chip.md): Shows a compact choice, a suggested action or an item the user entered as a small labelled control. - [Menu](https://tanrei.chnotchy.com/components/menu.md): Offers a short set of actions or choices on a temporary surface that opens from the element that asked for it, or at the point in an area where a person asked for it (a context menu), with a second level in a submenu where the set needs one. - [Slider](https://tanrei.chnotchy.com/components/slider.md): Lets people choose a value, or a range of values, from a continuous or stepped scale by dragging a handle along a track. - [Slider field](https://tanrei.chnotchy.com/components/slider-field.md): Lets people choose a value, or a range of values, on a scale under a label that says what is set and what it is set to, with a line of help and the reason a value was refused: a Field and a Slider as one component. - [Calendar](https://tanrei.chnotchy.com/components/calendar.md): Shows one month as a grid of days, in the page or inside a picker, lets a person choose one date or one range of dates from it, and moves from month to month as one column of weeks that follows a scroll and a drag. - [DateTimePicker](https://tanrei.chnotchy.com/components/date-time-picker.md): Lets a person choose a date, a time, or a date and time — or a span of any of them — from a Calendar and time wheels or a clock dial, in a dialog or in a surface that drops down from a field. - [Field group](https://tanrei.chnotchy.com/components/field-group.md): Names a set of controls that belong together — checkboxes that each have a name of their own, switches, or fields — with a label that can say the set is required or optional, a description, and one error for the set, and lays the controls out in a column or a row; it frames the set and never selects, moves focus or holds a value. Told that the set is the radio buttons of one group, it is their radio group for assistive technology, and is so the frame the Radio group is built from. - [Radio group](https://tanrei.chnotchy.com/components/radio-group.md): Asks one question that has exactly one answer among a few options shown all at once: a set of radio buttons that holds the chosen value, in the field group's frame: under a label that can say the answer is required or optional, with a description and one error for the set. - [Checkbox group](https://tanrei.chnotchy.com/components/checkbox-group.md): Asks one question that may have several answers among a few choices shown all at once: a set of checkboxes that holds the list of the checked values under one name, with a label that can say an answer is required or optional, a description and one error for the set, and, where wanted, one checkbox that checks them all. - [Select](https://tanrei.chnotchy.com/components/select.md): Lets people choose one value from a closed list: a trigger that looks and measures like a text input and shows the chosen option, and a list of options, optionally grouped, that opens from it. It has no label row and no message: a Field frames it — that pair is the select field — or the product names it where its label stands elsewhere, as in a header or a toolbar. (Variants Tanrei leaves out: filled, outlined.) - [Select field](https://tanrei.chnotchy.com/components/select-field.md): Lets people choose one value from a closed list as a field of a form: a label that can say the field is required or optional, a trigger that looks and measures like a text field's box and shows the chosen option, a list of options, optionally grouped, that opens from it, and a line of help or an error below. (Variants Tanrei leaves out: filled, outlined.) - [Menubar](https://tanrei.chnotchy.com/components/menubar.md): Keeps an application's commands within reach in one persistent row of named menus (File, Edit, View…), each opening a menu below its title, with the arrow keys moving along the row and into each menu; beside the menus the row may hold a few entries that act by themselves — an action or a link. - [File upload](https://tanrei.chnotchy.com/components/file-upload.md): Lets people choose files through a file picker and shows what was chosen as file items — each file with its name, its size, its progress and its error and the actions to retry and remove it, in a column of rows or a strip of tiles; it keeps the chosen files and lists them itself, so that a plain form works with nothing written, or hands the files to a product that gives the file items and draws the state that product gives back; and it never uploads anything itself. - [Drop zone](https://tanrei.chnotchy.com/components/drop-zone.md): Wraps any part of a screen — a list, a table, a whole working view — so that files can be dropped anywhere on it, while everything it holds is used exactly as without it: it draws nothing at rest and adds no hover, no press, no focus stop and no role; while files are dragged over it, one overlay covers it and says they can be dropped; and on the drop it judges the files by the File picker's rule and hands the product what passed and what was refused. It keeps nothing, and it is never the only way to add a file. - [Rating](https://tanrei.chnotchy.com/components/rating.md): Lets a person give a score out of a few marks — stars by default — or shows a score already given, a whole mark or, where the product allows it, a half mark at a time. - [Text field](https://tanrei.chnotchy.com/components/text-field.md): Lets people enter and edit text — one line, or several that follow the text or are resized by hand — or a date or a time entered unit by unit in the locale's form, or code held exactly as it is written, with a label that can say the field is required or optional, optional icons, prefix and suffix, supporting text, a character count and a picker button. (Variants Tanrei leaves out: filled, outlined.) - [Chip field](https://tanrei.chnotchy.com/components/chip-field.md): Collects a list of short texts — e-mail addresses, telephone numbers, keywords — typed one after another in one field: each text the product's check accepts becomes a chip that can be removed or taken back, and the list is the field's one value. (Variants Tanrei leaves out: filled, outlined.) - [Field](https://tanrei.chnotchy.com/components/field.md): Frames one control with what a form gives every field: a label above it that can say the control is required or optional, a line of help, and the reason a value was refused, each tied to the control for assistive technology; it is a frame, never a control. - [Combobox field](https://tanrei.chnotchy.com/components/combobox-field.md): Lets people find one value by typing, as a field of a form: a combobox — a box with a list of options that narrows as they type, or, where the product allows it, a value of their own — under a label that can say the field is required or optional, with a line of help and the reason a value was refused. (Variants Tanrei leaves out: filled, outlined.) - [Number field](https://tanrei.chnotchy.com/components/number-field.md): Lets people enter a number as a number — typed in their locale's form or stepped by a key or a button, kept within limits, with its unit beside it — as a field of a form that looks and measures like a text field. (Variants Tanrei leaves out: filled, outlined.) - [Color field](https://tanrei.chnotchy.com/components/color-field.md): Lets people set one color as a field of a form: a text value they can read, type and paste, a sample of it beside the text, and a button that asks for a picker; it looks and measures like a text field. (Variants Tanrei leaves out: filled, outlined.) - [One-time-code field](https://tanrei.chnotchy.com/components/one-time-code-field.md): Asks for a short code sent to the person as one complete field: a One-time-code input under the Field's label, with the Field's help and its error, tied together for assistive technology and taking part in a form as one control. - [Chat composer](https://tanrei.chnotchy.com/components/chat-composer.md): Lets a person write a message and send it, in one capsule that holds everything: a typing area that grows with what is written, the files attached to the message as a strip of File items above it, a product's own actions, and a send button that is enabled only while what is there can be sent; it reports the message when the person sends it and never sends anything itself. - [Card](https://tanrei.chnotchy.com/components/card.md): Sets a group of related content apart from its background, and can be one action that opens what it shows, or one link to it. - [Divider](https://tanrei.chnotchy.com/components/divider.md): Separates groups of content in a list, a layout or a toolbar with a thin line. - [Dialog](https://tanrei.chnotchy.com/components/dialog.md): Stops a person for a decision or a few details that the task cannot go on without, in a surface that dims and blocks everything behind it and always offers at least one answer, until one is chosen or the dialog is dismissed. - [List](https://tanrei.chnotchy.com/components/list.md): Holds a set of the product's own items — rows, tiles, cards, files — in one column, one line, or lines that wrap into a grid; people read them, open them one by one, choose from them, or drag them into another order. - [List row](https://tanrei.chnotchy.com/components/list-row.md): One row of text with something before it and something after it — a headline, a short line above it and a line or two below it; a glyph, a picture or a control at its start; a short value, a glyph or a control at its end — placed in a List's item, which it fits in every mode of the List, or standing alone. - [Bottom sheet](https://tanrei.chnotchy.com/components/bottom-sheet.md): Shows supplementary content or a short task in a surface that rises from the bottom edge, either over the lower part of the content while the rest stays usable, or as a modal step that dims and blocks everything else until it is dismissed. - [Side sheet](https://tanrei.chnotchy.com/components/side-sheet.md): Shows supplementary content or a secondary task in a panel at the end edge, beside the content on a wide screen or over it on a compact one, with a headline, a close button and actions: optional beside the content, at least one over it. - [Carousel](https://tanrei.chnotchy.com/components/carousel.md): Lets people browse a row of visual items that scrolls sideways around one item in focus, in the centre or at the start, the others narrower or smaller as they move away and always the same gap apart, each item opening what it shows; a featured row may loop, show its position in dots and advance by itself, with a control to stop it. - [Code block](https://tanrei.chnotchy.com/components/code-block.md): Shows lines of code to read, compare and copy: in the code face, on a quiet fill or inside one hairline, scrolling inside itself or wrapping, with an optional header, line numbers, marked lines, a prompt and a copy button; given the code and its language it highlights the code by itself, in the system's syntax colors. - [Table](https://tanrei.chnotchy.com/components/table.md): Presents data that has rows and columns — a price list, a comparison, a list of settings, a status of many things, the records a person works with — with named columns, optional row headers, a caption and footer rows; it scrolls in its own box when it does not fit; a column's header can ask for the rows in its order and rows can be chosen, while the table itself never sorts, filters, fetches or pages. - [Popover](https://tanrei.chnotchy.com/components/popover.md): Shows content a person can read and operate on a small surface that opens beside a control — when it is pressed, or as a pointer or keyboard focus rests on it — and stays with it, without dimming or blocking the rest of the page; in a compact window, in a modal surface with the bottom sheet's appearance. - [Steps](https://tanrei.chnotchy.com/components/steps.md): Sets a procedure out as numbered steps — each a ring with its number, an optional title and a body of the product's content, joined to the next by a hairline — for a reader to work through in order; an ordered list to read, never a control and never a record of progress. - [Accordion](https://tanrei.chnotchy.com/components/accordion.md): Content that a row shows and hides in place: one item is a single disclosure, several are a set whose items open by themselves or one at a time; each header is a button with a label, an optional glyph, second line and short value, and a chevron that turns; as rows on the surface or bounded by one hairline, ruled by a line or parted by a gap, with room for reading or drawn closer among controls. - [Description list](https://tanrei.chnotchy.com/components/description-list.md): Presents what is known about one thing as named facts — a quiet term and the value that answers it — with the terms in one column beside their values, above them, or under a large figure; laid out by its own width and never a control. - [Figure](https://tanrei.chnotchy.com/components/figure.md): Sets one thing to look at — a picture, a chart, a specimen, a live example — on a stage of its own, framed or not, with a caption that says what it shows, and optionally a title with the product's controls above and a joined block beneath. - [App shell](https://tanrei.chnotchy.com/components/app-shell.md): Frames a page or an app: places a header, the navigation, the main content, an aside and a footer, decides from the window's width how each of them is shown, and lets a keyboard reach the content in one step; it draws the frame and none of what stands in it. - [Page header](https://tanrei.chnotchy.com/components/page-header.md): The head of a page's content: the page's title as its heading, with a sentence that says what the page is, a line of facts about it, the actions for the whole page and the way back up above it — in the content, scrolling with it, laid out by its own width, and never a control. - [Tree view](https://tanrei.chnotchy.com/components/tree-view.md): A hierarchy of items that open and close: rows that begin further in at each level, a chevron at the start or the end of every row that holds others — or none, the folder glyph opening — an optional glyph, a name on one line, a note below it or beside it and a short value; read and opened only, or with one item or several chosen by the quiet selection, names edited in place and new items named in a row of their own where the product asks; the rows of the open parents above what is shown pinned at the top while it scrolls; moved through with the arrow keys as one stop in the focus order; with room for touch or drawn closer for a tool and for a small tree inside text. - [Timeline](https://tanrei.chnotchy.com/components/timeline.md): Sets events out in the order of time — each a marker at the start edge, its time, a title and an optional body, joined to the next by a hairline — and, where the events have one, shows which are done, which is under way and which are still ahead by the marker's shape and in words; an ordered list to read, never a control. - [Image preview](https://tanrei.chnotchy.com/components/image-preview.md): Shows one picture of a set over the whole window when the person presses its thumbnail, to be looked at closely — enlarged and back by a double tap, a pinch, a control or a key, moved about while enlarged — and moved on to the next picture or back, until it is closed. - [Handle](https://tanrei.chnotchy.com/components/handle.md): The mark a person drags, or moves from the keyboard, to change the size of what it stands on — a sheet, a field, a pane, a preview frame: a short capsule for one axis, a quarter-circle arc for two; it tells its owner how far it was moved and never sizes anything itself. - [Resizable frame](https://tanrei.chnotchy.com/components/resizable-frame.md): Gives content — a component preview, a page in an embedded document, a pane or side bar of the product's own — a width and a height that a person changes by dragging a handle on its edge or its corner, from the keyboard or by activating the handle: outlined, a box to check how the content responds to the room it is given; plain, the edge of a pane. - [Split view](https://tanrei.chnotchy.com/components/split-view.md): Divides a region into two panes side by side or one above the other, with a Handle on the line between them that a person drags, steps from the keyboard or presses to give one pane more room, and, where the product allows it, to fold one pane away and bring it back. - [Scroll area](https://tanrei.chnotchy.com/components/scroll-area.md): A box that scrolls the product's content with the platform's own scrolling and shows, at each edge it watches, that more lies beyond it — a band in the surface's color, a fade of the content, a line or a blur, as the design system or the instance chooses — without changing its size or moving the content. - [Size transition](https://tanrei.chnotchy.com/components/size-transition.md): Wraps content whose size changes — a message that grows, a section that gains a line, a panel that loses a row — and moves its own size to the content's new size as one motion, so that what stands after it moves smoothly instead of jumping, while the edge it is anchored to stays still. - [Badge](https://tanrei.chnotchy.com/components/badge.md): Marks an icon, a navigation item or an avatar with a dot or a small count to show that something is waiting. - [Progress indicator](https://tanrei.chnotchy.com/components/progress-indicator.md): Shows how far a task has come, or that it is under way when how far is unknown, as a bar or a ring. - [Meter](https://tanrei.chnotchy.com/components/meter.md): Shows where a known value stands in a known range — storage used, a battery's charge, a quota, the strength of a password — as a bar or a ring that looks like the progress indicator, without saying that anything is under way. - [Number ticker](https://tanrei.chnotchy.com/components/number-ticker.md): Shows a number that changes — a count, a price, a score, a figure on a dashboard — by moving each changed digit to its new value, so that a person sees that it changed, which way and roughly by how much, while assistive technology is told only the value it settles on. - [Loading indicator](https://tanrei.chnotchy.com/components/loading-indicator.md): Shows that a short wait of unknown length is under way, inline or over content. - [Snackbar](https://tanrei.chnotchy.com/components/snackbar.md): Tells a person briefly, at the bottom edge of the screen or at its top end, what the app just did or what happened (neutrally, or as information, a warning, an error or a success), on a raised surface of the scheme or as a bar of the opposite scheme, with at most one action, without taking focus or interrupting their work. - [Tooltip](https://tanrei.chnotchy.com/components/tooltip.md): Describes an element in a few words when a person points at it, focuses it with the keyboard or long-presses it, without taking focus or blocking anything. - [Keyboard shortcut](https://tanrei.chnotchy.com/components/keyboard-shortcut.md): Shows the keys that perform a command, as keys or as text, in the modifier symbols and names of the keyboard the person is using, and gives assistive technology one text in their place. - [Tag](https://tanrei.chnotchy.com/components/tag.md): Names a category or a status with a short static label, quietly, outlined or filled, in the colors of a status where it has one; it is text, never a control. - [Inline code](https://tanrei.chnotchy.com/components/inline-code.md): A run of code inside a sentence — a command, a name, a value — in the code face at the size of the text around it, on a faint fill or plain; it is text, never a control, and never highlighted. - [Callout](https://tanrei.chnotchy.com/components/callout.md): A notice that is part of the content and stays there: a note, a caution, the reason for something or a summary of what is wrong, in the flow of the page, as a quiet fill or an outline, in the colors and with the glyph of a status where it has one, with an optional title, actions and a close button; announced only when it appears in answer to something. - [Avatar](https://tanrei.chnotchy.com/components/avatar.md): Stands for a person, or for a team or a project, by a small picture, by initials or a glyph where there is no picture, in a round or a square box of three sizes; several are shown as one overlapping group that counts the ones it does not draw. A picture, never a control. - [Empty state](https://tanrei.chnotchy.com/components/empty-state.md): Stands in the place of content that is not there — a search with no results, a list nobody has added to, a page before its first item — and says what is missing, why or what to do, and offers the action that does it; quiet, flat, and announced only when it appears in answer to something. - [Tag group](https://tanrei.chnotchy.com/components/tag-group.md): Lays out a set of tags or chips in lines that wrap, spaced for what it holds, and exposes the set as one named list; the members stay what they are, and after a chip is removed focus goes on to the next. - [Skeleton](https://tanrei.chnotchy.com/components/skeleton.md): Stands where content will be while it loads: quiet placeholders in the shape of what is coming — lines of text, a block, a circle — that keep the box the content will take, in a region that says once that it is busy. - [File item](https://tanrei.chnotchy.com/components/file-item.md): Shows one file — a glyph that says its format or a small picture of it, its name, and what the product says of it: its format, its size, where its sending stands, what went wrong — with the actions to take it back and to try it again, as a row of a column of files or as a tile of a strip of pictures; it can be pressed as a whole to open the file; and it never reads, keeps or sends the file itself. - [Swatch](https://tanrei.chnotchy.com/components/swatch.md): Shows a color as a sample with its name beside it: a small square or dot of exactly that color, over a checkerboard where the color lets what is behind it through, edged so that a color close to the surface still shows where it ends. A sample to look at, never a control and never a picker. - [Marquee text](https://tanrei.chnotchy.com/components/marquee-text.md): One line of text that does not fit its place and, when its trigger says — while hovered or focused, or all the time — scrolls sideways at a steady pace to show all of it, resting at its start between passes, and otherwise rests cut with an ellipsis; it moves only when the text overflows, never where motion is reduced, and is read once, whole. - [Tabs](https://tanrei.chnotchy.com/components/tabs.md): Switches between views of the same subject with a row of labelled tabs, one of them selected and marked by an indicator that slides between them and follows a finger dragged across the row: in three weights (primary, secondary, tonal), on a track or straight on the surface the row stands on, as tall as a screen's views need or as low as a header allows, and with the slide or without it. - [Tab view](https://tanrei.chnotchy.com/components/tab-view.md): Shows the view of the selected tab under its own row of Tabs, or linked to a row placed elsewhere, and lets a person swipe from view to view with the tabs' indicator following the finger. - [App bar](https://tanrei.chnotchy.com/components/app-bar.md): Names the current screen at its top edge and holds the way back and the screen's actions — as many as its row has room for, the rest in an overflow menu or left out, as the product chooses — its bottom edge drawn as the edge of a region that stays (or, where the design system chooses, only once content scrolls under it). - [Navigation bar](https://tanrei.chnotchy.com/components/navigation-bar.md): Moves between three to five top-level destinations from the bottom edge of a compact screen, and shows which one is current with an indicator that slides between them and follows a finger dragged across the bar. - [Navigation drawer](https://tanrei.chnotchy.com/components/navigation-drawer.md): Lists a product's destinations in a panel at the start edge, grouped under headings and in groups that open and close, beside the content or over it, and narrows to a column of icons where the content needs the width, on request or by the window's width. Its destinations are buttons, or links to the product's pages: it is then a site's sidebar, which marks the page being shown. - [Search](https://tanrei.chnotchy.com/components/search.md): Lets people search the product from a bar or a compact trigger, and offers suggestions and results while they type in a view under the bar, in a dialog or over the whole screen. - [Link](https://tanrei.chnotchy.com/components/link.md): Text that leads somewhere: a phrase inside a sentence, a line by itself, or a glyph alone; in the text style of where it sits, underlined as the design system chooses (at rest, in the default system), marked where it leaves the site, and the platform's own link. - [Pagination](https://tanrei.chnotchy.com/components/pagination.md): Moves through the numbered pages of one list — search results, the posts of a blog, the rows of a table: a row of page numbers with the current page marked and the pages that do not fit left out behind an ellipsis, previous and next, first and last where the product asks for them, and a short form that says which page of how many. Each page is a link to its address, or a button where the product changes the page in place. - [Previous and next links](https://tanrei.chnotchy.com/components/previous-next-links.md): Offers the page before and the page after the one a person is on, in a sequence of pages: two links, each named by a direction and the title of where it leads. - [Stepper](https://tanrei.chnotchy.com/components/stepper.md): Shows where a person is in a flow the product runs in a fixed order of steps — which step is current, which are complete, which has an error and which are still to come — and, where the product allows it, lets the person press a step to go back to it. - [Breadcrumbs](https://tanrei.chnotchy.com/components/breadcrumbs.md): Shows where a page sits in a hierarchy of pages and leads back up it: the levels above as links, in order from the top, with the page itself last. - [Table of contents](https://tanrei.chnotchy.com/components/table-of-contents.md): Lists the headings of the page the person is reading as links to them, sub-headings set in under their heading, and marks the one whose section is being read; where there is no room beside the text, one row that names the current section and opens the same list. - [Link card](https://tanrei.chnotchy.com/components/link-card.md): One link drawn as a block: the destination's title, a sentence about it, its picture and the site it is on, from values the card is given and never loads. - [Prose](https://tanrei.chnotchy.com/components/prose.md): Long-form text — a help article, release notes, legal terms, anything written in Markdown or delivered by a CMS — set in the system's text styles by level, with one vertical rhythm and a limit on line length. A foundation rather than a control: prose styles and spaces the blocks a renderer produces, and the components placed among them; it does not parse anything. ## Advanced components in Tanrei Parts a product usually reaches through a component built from them. - [File picker](https://tanrei.chnotchy.com/components/file-picker.md): Lets people choose files through the platform's own picker — from a button and, where there is room, from a place files can also be dragged onto — states the limits in words before the choice, judges what was chosen against them, and hands the product what passed and what was refused; it keeps nothing, lists nothing and takes no part in a form, so whoever holds the files shows them. Used in: File upload, Chat composer. - [Text input](https://tanrei.chnotchy.com/components/text-input.md): The box people type in — one line, or several that follow the text or are resized by hand; a date or a time entered unit by unit in the locale's form; code held exactly as it is written — with optional icons, a prefix and a suffix, a picker button and, in the looks that float one, its label inside the box. It has no label row and no message: a Field frames it, or the product names it. Used in: Text field, Chip field. (Variants Tanrei leaves out: filled, outlined.) - [Combobox](https://tanrei.chnotchy.com/components/combobox.md): Lets people find one value, or several, by typing: a box that looks and measures like a text input, with a list of options that narrows as they type and that they choose from, or, where the product allows it, a value of their own; several chosen values stand in the box as removable chips. It is the bare control, with no label row and no message: a Field frames it — the combobox field is that pair — or the product names it. Used in: Combobox field. (Variants Tanrei leaves out: filled, outlined.) - [Number input](https://tanrei.chnotchy.com/components/number-input.md): The box people enter a number in — typed in their locale's form or stepped by a key or by one of its two buttons, kept within limits, with its unit beside it — drawn as the text input beside it and, in the looks that float one, with its label inside the box. It has no label row and no message: a Field frames it, or the product names it. Used in: Number field. (Variants Tanrei leaves out: filled, outlined.) - [Color input](https://tanrei.chnotchy.com/components/color-input.md): The box in which people set one color: a text value they can read, type and paste, a sample of it beside the text, a button that asks for a picker and, in the looks that float one, its label inside the box; it looks and measures like a text input. It has no label row and no message: a Field frames it, or the product names it. Used in: Color field. (Variants Tanrei leaves out: filled, outlined.) - [One-time-code input](https://tanrei.chnotchy.com/components/one-time-code-input.md): Takes a short code sent to the person — a sign-in or verification code — as one text value drawn in separate cells, so that its length and what is still missing can be seen, and the platform can fill it in one step. Used in: One-time-code field. - [Embedded text input](https://tanrei.chnotchy.com/components/embedded-text-input.md): The typing alone, for a box that something else draws: text, a placeholder, the caret and the selection, on one line or on lines that grow and shrink with a motion. It draws no container, edge, fill, label, message or state layer and no focus indication; whatever holds it draws the box and shows the focus, and decides what its action is. Used in: Chat composer. - [Modal layer](https://tanrei.chnotchy.com/components/modal-layer.md): The layer under every modal surface: it dims the window behind what it presents, makes everything there inert, moves focus in, keeps it there and gives it back, and asks to close on Escape, the platform's back or a press on the dim — so that every modal surface of a product behaves as one and is restyled in one place. Used in: Dialog, Navigation drawer, Search, Bottom sheet, Side sheet, DateTimePicker, Image preview. ## Components not in Tanrei Do not use these with Tanrei: they are documented for the systems that ship them. - [Segmented button](https://tanrei.chnotchy.com/components/segmented-button.md): Lets people choose one option, or several, from two to five related options drawn side by side as the joined segments of one control. Tanrei leaves it out. Instead use: Tabs, Radio button, Button group. One choice among several is told by what it changes: tabs where it switches the content below, radio buttons where it sets a value, a button group where each button toggles on its own. Only in: `cupertino`, `m3-like`. - [FAB menu](https://tanrei.chnotchy.com/components/fab-menu.md): Opens a short list of related actions from a toggle drawn as a collapsed main action button, which turns into the list's close button while they show. It lives in the `m3-like` layer, which Tanrei does not extend. Instead use: Main action button, Bottom sheet. A system outside this layer draws no floating action button that opens a list: its main action button opens a bottom sheet that lists the related actions. Only in: `m3-like`. ## Design systems - [Tanrei](https://tanrei.chnotchy.com/systems/tanrei/llms.txt): The default design system. Near-monochrome surfaces and a monochrome primary, which it shares with the grey root it extends; over them, its own colors: one accent, the keyboard focus ring; status messages on quiet tints of their hue; and code in a conventional, vivid scheme. It leaves out the components and variants it does not draw. - [Cupertino (Apple HIG-inspired)](https://tanrei.chnotchy.com/systems/cupertino/llms.txt): An independent approximation of the look of Apple's platforms, expressed purely as values: a saturated system tint, pure white and black canvases, gray fills with tinted labels, rounded rectangles, no hover state and a dimmed pressed state. - [M3-like (Material 3-inspired)](https://tanrei.chnotchy.com/systems/m3-like/llms.txt): An independent approximation of Material Design 3's baseline look, expressed purely as values over Tanrei's vocabulary: a chromatic primary, tonal surfaces, pill buttons, shadow elevation without a ring. ## Project - [Status](https://tanrei.chnotchy.com/status.md): Which component exists on which platform, generated from the repository. - [How Tanrei is built](https://tanrei.chnotchy.com/project/how-tanrei-is-built.md): Two sources of truth, a spec-first workflow and drift checks that keep five platforms, the docs and the status matrix in agreement. - [Contributing](https://tanrei.chnotchy.com/project/contributing.md): Why Tanrei does not accept outside contributions, how to report a bug or ask a question, and where the rules live. - [License and attribution](https://tanrei.chnotchy.com/project/license.md): Tanrei's license and the work it builds on. ## Optional - [llms-full.txt](https://tanrei.chnotchy.com/llms-full.txt): The spec of every component Tanrei ships, as Markdown, in one file. - [Source repository](https://github.com/chnotchy/tanrei): The tokens (`tokens/`), the specs (`specs/`) and every platform's package.