# Docs

- Native: React Native components for Expo and bare React Native.
  - Getting Started

    - **Overview**
    - [Introduction](/docs/native/getting-started): A React Native component library built on Uniwind, Reanimated and the Gesture API.
    - [Installation](/docs/native/getting-started/installation): Install the package, wire up Tailwind, and mount the root provider.
    - [Design Principles](/docs/native/getting-started/design-principles): The rules every component in the library follows, and why.

    - **Handbook**
    - [Provider](/docs/native/getting-started/provider): Every provider an app needs at its root, in one component.
    - [Theming](/docs/native/getting-started/theming): Tokens, the light and dark palettes, and theming a navigator from them.
    - [Styling](/docs/native/getting-started/styling): How className merging, tv() slots and the two mergers fit together.
    - [Sizing](/docs/native/getting-started/sizing): The semantic token scales, and the precedence ladder an icon's size resolves through.
    - [Composition](/docs/native/getting-started/composition): Compound components, the context hooks, and the rules for composing your own parts.
    - [Icons](/docs/native/getting-started/icons): Central Icons, inherited defaults, and the one withUniwind wrapper.

    - **UI for Agents**
    - [LLMs.txt](/docs/native/getting-started/llms): Machine-readable copies of every page on this site.
    - [AGENTS.md](/docs/native/getting-started/agents): The in-repo manual coding agents read before touching the library.
  - Components
    - [All Components](/docs/native/components): Every component in Delacour UI Native, grouped by what it does.

    - **Actions**
    - [Button](/docs/native/components/button): A pressable action, with composed icons and a loading state that costs no layout.
    - [Pressable](/docs/native/components/pressable): The Gesture API primitive every pressable in the library is built on.

    - **Forms**
    - [Field](/docs/native/components/field): A form field's layout, and the one place its state is written down.
    - [Input](/docs/native/components/input): A text field, and the box that can hold content beside it.
    - [Checkbox](/docs/native/components/checkbox): A box that is ticked or not — alone, or as one of a group sharing a value list.
    - [Radio](/docs/native/components/radio): One choice from a set, with a trailing indicator row.
    - [Switch](/docs/native/components/switch): An on/off control with a thumb you can drag as well as tap.
    - [Slider](/docs/native/components/slider): A value picked from a range by dragging a handle along a track.

    - **Data Display**
    - [Text](/docs/native/components/text): The type scale, and the one component that reproduces React Native's text inheritance through classNames.
    - [Badge](/docs/native/components/badge): A compact label for status, category or count.
    - [Icon](/docs/native/components/icon): Central Icons, sized and coloured by inheritance.
    - [ListGroup](/docs/native/components/list-group): A surface grouping related rows, with dividers inserted for you.
    - [Separator](/docs/native/components/separator): A one-pixel rule, hidden from assistive technology.
    - [Accordion](/docs/native/components/accordion): Sections that expand and collapse, animated from a measured height.

    - **Feedback**
    - [Spinner](/docs/native/components/spinner): An animated loading indicator that stands in for an icon.

    - **Overlays**
    - [BottomSheet](/docs/native/components/bottom-sheet): A sheet that rises from the bottom edge, built on @gorhom/bottom-sheet.

    - **Navigation**
    - [Tabs](/docs/native/components/tabs): A row of tabs and the panels they switch between, with a swipeable pager.

    - **Layout**
    - [Screen](/docs/native/components/screen): A screen's frame — pinned chrome, a content region, and whatever scrolls between them.

    - **Utilities**
    - [DelacourProvider](/docs/native/components/provider): Every provider an app needs at its root, in one component.
  - CLI

    - **Overview**
    - [Overview](/docs/native/cli): Copy component source into your project instead of installing a package.
    - [Setting up a project](/docs/native/cli/init): What init changes, what it leaves alone, and the three things it hands back to you.

    - **Guides**
    - [Monorepos](/docs/native/cli/monorepo): A shared package or straight into the app — and the symlink that silently strips your styles.
    - [Troubleshooting](/docs/native/cli/troubleshooting): The ten doctor checks, and the silent failure each one exists to catch.

    - **Reference**
    - [Commands](/docs/native/cli/commands): Every command, and the flags they share.
    - [native-components.json](/docs/native/cli/configuration): Where components go, how they import each other, and which app to wire up.
    - [The registry](/docs/native/cli/registry): Where components come from, how a version is pinned, and how to serve your own.

    - **UI for Agents**
    - [MCP server](/docs/native/cli/mcp): Give a coding agent the real components instead of plausible ones.
  - Releases
    - [Releases](/docs/native/releases): What has landed in @delacour/native-ui, newest first.