---
title: Quickstart
description: Install the Expo Development Foundation skills and start a routed session.
---

# Quickstart

## Prerequisites

- Clone this repository.
- Node.js 22.13 or newer.
- Python 3.

## 1. Choose one installation strategy

### Full vendored snapshot

Install the foundation-owned skills and local vendored copies of official Expo
skills for reproducible offline routing:

```bash
./Scripts/install-skills.sh --tier all
```

### Foundation-only plus canonical Expo skills

Keep Expo's upstream skills canonical and install only this repository's router
and workflows:

```bash
npx skills@latest add expo/skills --skill '*'
./Scripts/install-skills.sh --tier foundation
```

Use `--target-dir "$HOME/.agents/skills"` with either strategy when that is the
explicit directory configured for your workspace. Installing into a directory
does not prove host discovery.

## 2. Check the same target and tier

For the full snapshot:

```bash
./Scripts/install-skills.sh --status --tier all
```

For foundation-only, use `--status --tier foundation`. Repeat the same
`--target-dir` if you supplied one during installation.

## 3. Copy a prompt

Audit an existing app:

```text
Use $expo-development-foundation to audit this existing Expo app at standard depth. Start with project orientation, remain read-only, cite file evidence for every finding, include design and accessibility when UI is present, run only safe local verification, and report skipped checks plus residual risk.
```

Create a new app:

```text
Use $expo-development-foundation to create a new Expo app from this request. Route through $expo-bootstrap, choose only the required child skills, prefer Expo Go for compatible JavaScript-only work, and do not run EAS or other cloud actions without explicit authorization.
```

Change an existing feature:

```text
Use $expo-development-foundation for this existing Expo app. Orient first, shortlist only the skills needed for the requested change, preserve the current architecture, implement only because this prompt authorizes the requested change, and close with $expo-verify.
```

## 4. Expect this first response

The router should report:

- workspace classification;
- a stack card for an existing app;
- an ordered, focused skill shortlist; and
- an explicit proceed or stop boundary based on authorization.

## Maintaining the foundation

These checks are for maintainers, not the beginner install path:

```bash
npm run verify
```

The aggregate command clean-installs both lockfiles, verifies the catalog,
installer, and consumer guidance, runs the docs `validate`/`check`/`build`
gates, and checks the showcase with lint, TypeScript, deterministic tests, Expo
Doctor, web export, and its local web smoke journey. The smoke journey uses
`SHOWCASE_CHROME_PATH` when set, the default macOS Chrome path when present,
and otherwise Playwright's bundled Chromium. Remote CI runs the same docs
`check`, showcase tests, and smoke journey (see `.github/workflows/ci.yml`).
It does not run native-device checks, EAS, deployment, telemetry, or other
cloud actions. Use the focused commands in the scripts reference when
debugging one layer.
