# Docs

- [Design](/docs/design): How @nyte-ai/core is put together: content-addressed objects, atomic refs, fenced leases, and one ordered event stream

# Cloud

- [Introduction](/cloud/introduction): Cloud is Nyte's design system: the tokens, primitives, and application surfaces shared by the web, desktop, and terminal hosts

- **Foundations**
- [Tokens](/cloud/foundations/tokens): The --nyte-* custom properties every primitive is built from, read live from @nyte-ai/ui
- [Theming and styling channels](/cloud/foundations/theming): How a consumer changes what a primitive looks like without forking it: token overrides, className, and xstyle
- [Focus and keyboard](/cloud/foundations/focus): The focus ring, the pointer/keyboard modality switch, and the keyboard model every primitive inherits from Base UI
- [Icons](/cloud/foundations/icons): Central Icons in two stroke geometries, and the 16px IconBox that keeps a glyph on the grid

- **Primitives**
- [Button](/cloud/primitives/button): The styled Base UI button: four variants, three sizes, and an unstyled escape hatch
- [Avatar](/cloud/primitives/avatar): Image with initials fallback in four sizes, two shapes, and five tones
- [Input](/cloud/primitives/input): A single-line text field on the field tokens, with invalid and disabled states
- [Textarea](/cloud/primitives/textarea): A multi-line field with the same tokens as Input and vertical resize
- [Dialog](/cloud/primitives/dialog): A modal on the popover tokens: portal, scrim, centered popup, and a built-in close button
- [Alert dialog](/cloud/primitives/alert-dialog): The Dialog surface with the alert semantics: no outside dismissal, no close button, the user must choose
- [Dropdown menu](/cloud/primitives/dropdown-menu): A Base UI menu on the menu tokens: items, radio groups, submenus, labels, shortcuts, separators

- **Headless**
- [Overview](/cloud/headless): The eighteen Base UI namespaces @nyte-ai/ui re-exports without styling, and which desktop files consume each
- [Alert Dialog](/cloud/headless/alert-dialog): A dialog that requires a user response to proceed.
- [Autocomplete](/cloud/headless/autocomplete): An input that suggests options as you type.
- [Button](/cloud/headless/button): A button component that can be rendered as another tag or focusable when disabled.
- [Collapsible](/cloud/headless/collapsible): A collapsible panel controlled by a button.
- [Context Menu](/cloud/headless/context-menu): A menu that appears at the pointer on right click or long press.
- [Dialog](/cloud/headless/dialog): A popup that opens on top of the entire page.
- [Menu](/cloud/headless/menu): A list of actions in a dropdown, enhanced with keyboard navigation.
- [Number Field](/cloud/headless/number-field): A numeric input element with increment and decrement buttons, and a scrub area.
- [Popover](/cloud/headless/popover): An accessible popup anchored to a button.
- [Preview Card](/cloud/headless/preview-card): A link that shows a destination preview without interrupting keyboard or screen reader navigation.
- [Select](/cloud/headless/select): A common form component for choosing a predefined value in a dropdown menu.
- [Slider](/cloud/headless/slider): An easily stylable range input.
- [Switch](/cloud/headless/switch): A control that indicates whether a setting is on or off.
- [Tabs](/cloud/headless/tabs): A component for toggling between related panels on the same page.
- [Toggle](/cloud/headless/toggle): A two-state button that can be on or off.
- [Toggle Group](/cloud/headless/toggle-group): Provides a shared state to a series of toggle buttons.
- [Toolbar](/cloud/headless/toolbar): A container for grouping a set of buttons and controls.
- [Tooltip](/cloud/headless/tooltip): A popup that appears when an element is hovered or focused, showing a hint for sighted users.

- **Desktop**
- [Overview](/cloud/desktop): The desktop renderer's own component tier: headless Base UI under StyleX on the desktop palette
- [Theme variables](/cloud/desktop/theme): t.* appearance constants, the geometry schema, layers, and the floating surface shared by every popup
- [Button and focus](/cloud/desktop/button): components/ui.tsx: Button, IconButton, ToggleIconButton, Hint, StatusDot, Kbd, and the two focus rings
- [Menu](/cloud/desktop/menu): components/menu.tsx: the one menu surface for pane headers, sidebar filters, model chip, context menus, and the command palette
- [Confirm dialog](/cloud/desktop/confirm-dialog): components/confirm-dialog.tsx: the desktop's destructive confirmation on the headless alert dialog
- [Toaster](/cloud/desktop/toaster): components/toaster.tsx: Sonner mounted once, styled on the palette, with Nyte icons and one dismiss label
- [Spinner and animated number](/cloud/desktop/feedback): Two small motion primitives: a three-dot spinner and a tabular number that morphs on update
- [Icons](/cloud/desktop/icons): components/icons.tsx and file-type-icon.tsx: semantic icon names over central-icons-desktop, and Pierre file identity
- [Settings controls](/cloud/desktop/settings-controls): chrome/settings-controls.tsx: the row, select, switch, and stepper every Settings page is built from

- **Surfaces**
- [Model picker](/cloud/surfaces/model-picker): Choosing the model, reasoning level, and fast mode for a chat
- [Settings](/cloud/surfaces/settings): General, Appearance, Models, Usage, and Accounts: one route, one navigation, one row grammar
- [Command palette and search](/cloud/surfaces/command-palette): ⌘K: sessions, files, actions, and settings in one modal menu, and the client action table it draws from
- [Session list and sidebar](/cloud/surfaces/sidebar): The rail: workspaces, session rows, filters, previews, context menus, drag to split, and the resize handle
- [Transcript and tool calls](/cloud/surfaces/transcript): Turns, user messages, reasoning, work groups, tool calls, prose, and code: how a conversation is drawn
- [Diff view](/cloud/surfaces/diff-view): One diff surface for transcript receipts, the Changes panel, and stacked review
- [Composer](/cloud/surfaces/composer): The input surface: Lexical editor, reference chips, @ and / suggestions, attachments, lanes, and the queued-message card
- [Permission and consent prompts](/cloud/surfaces/consent): Web-search consent cards parked in the transcript, and the workspace trust gate
- [Tasks and jobs](/cloud/surfaces/jobs): Subagents and background commands: the count under the composer and the task list it opens
- [Workbench](/cloud/surfaces/workbench): The side stage: rail, tab strip in the titlebar, files, changes, terminal, and browser panels, and the pane layout around it
- [Toasts and notices](/cloud/surfaces/toasts): Where a message goes when it is not part of a form or a transcript