Learn how to install and use Expo App UI in your Expo React Native project. Quick start guide with installation, path aliases, and auto-dependency detection.

:::tip[Designed for production] Every component in this library is built for real apps, not demos. That means TypeScript strict mode, accessibility props wired up, New Architecture (Fabric) compatibility, minimal peer dependencies so your bundle stays light, and an automated test suite for the CLI. Customize freely — the patterns are already production-grade. :::

Installation

Using npx (Recommended)

No installation required. Use directly with npx:

npx expo-app-ui <command>

Global Installation

Install globally for easier access:

npm install -g expo-app-ui
expo-app-ui <command>

Quick Start

Add a component to your project:

npx expo-app-ui add custom-text

Path Aliases

Make sure your project has path aliases configured.

tsconfig.json

{
  "compilerOptions": {
    "paths": {
      "@/*": ["./*"]
    }
  }
}

babel.config.js

module.exports = function(api) {
  api.cache(true);
  return {
    presets: ['babel-preset-expo'],
    plugins: [
      [
        'module-resolver',
        {
          root: ['./'],
          alias: {
            '@': './',
          },
        },
      ],
    ],
  };
};

Auto-Dependency Detection

The CLI automatically detects when a component requires:

normalizeSize helper
theme constants
Related components or contexts

These dependencies are automatically added to your project if they don't already exist.

Getting Started