This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.

Create a project

Edit page

Learn how to create a new Expo project.


Expo is a React Native framework that makes developing Android and iOS apps easier. Our framework provides file-based routing, a standard library of native modules, and much more. Expo is open source with an active community on GitHub and Discord.

We also make Expo Application Services (EAS), a set of services that complement the Expo framework in each step of the development process.

System requirements

Start with a default project

We recommend starting with the default project created by create-expo-app. The default project includes example code to help you get started.

To create a new project, run the following command:

Terminal
- npx create-expo-app@latest
- yarn create expo-app
- pnpm create expo-app
- bun create expo

Start from an example

Instead of the default project, you can start from one of the Expo examples. These are small apps that each demonstrate a specific feature or integration, such as Expo Router, Expo Widgets, or a camera screen.

To browse the full list and pick one interactively, run create-expo-app with the --example option and no name:

Terminal
- npx create-expo-app@latest --example
- yarn create expo-app --example
- pnpm create expo-app --example
- bun create expo --example

To create a known example directly, pass its name:

Terminal
- npx create-expo-app@latest --example with-widgets
- yarn create expo-app --example with-widgets
- pnpm create expo-app --example with-widgets
- bun create expo --example with-widgets

Set up an AI agent

A new project includes AGENTS.md with project context for AI agents. When Claude Code is installed, it also includes .claude/settings.json to enable the Expo plugin. Claude Code and Codex have an official Expo plugin. Using one command, you can install Expo Skills and register the Expo Model Context Protocol (MCP) Server:

Terminal
- claude plugin install expo@claude-plugins-official

Then run /mcp inside your Claude Code session to sign in to your Expo account.

The plugin also installs the skill that teaches an agent where files live in a new Expo project:

expo-project-structure

Folder structure for a new Expo app.

For Cursor and other agents, install Expo Skills and the Expo MCP Server separately. The AI agents and Expo overview covers setup for each agent.

Next step

You have a project. Now it's time to set up your development environment so that you can start developing.