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

Grok Build and Expo

Edit page

Use Grok Build to build, upgrade, debug, and deploy your Expo and React Native projects.


Grok Build is xAI's terminal-based AI coding agent. It can read and write files across your project, run terminal commands, and browse the web. Expo projects created with create-expo-app are scaffolded with an AGENTS.md file that Grok Build reads directly. It can also check Expo Services and Expo CLI logs, fetch documentation from the Expo Model Context Protocol (MCP) Server, use Expo Skills for best practices, manage your Expo Services deployment workflow, and more.

Quick start

1

Install Grok Build

Install Grok Build, then start it from any project. For other install methods, see the Grok Build documentation.

Terminal
- curl -fsSL https://x.ai/cli/install.sh | bash

2

Create a new Expo project

Create a project with the following command or ensure your existing project has the latest expo package installed.

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

3

Install the Expo plugin

Install the official Expo plugin so Grok Build knows Expo conventions and can work with your Expo Services projects. One command installs Expo Skills and registers the Expo MCP Server:

Terminal
- grok plugin install expo --trust

You can also type /marketplace inside Grok Build and install expo from the catalog.

Then sign in to your Expo account. Type /mcps inside your Grok Build session, select expo, and press I. Grok Build opens the sign-in page in your browser.

The guides below cover the available skills and everything else the MCP Server can do:

Expo Skills

Browse the full list of skills the plugin provides, and see install options for other agents.

Expo MCP Server

Connect the remote Expo MCP Server to give agents live access to Expo documentation and Expo Services.

4

Open your project and start prompting

Run Grok Build from your project root, then describe what you want to do.

Terminal
- cd my-app

- grok

5

Verify setup

Paste the following prompt in your Grok Build session to confirm it can read your project:

Example prompt
Open package.json and tell me which Expo SDK version this project targets.

If the agent replies with the SDK version from package.json, the agent is reading your project correctly.

How Grok Build reads your Expo project

When you start Grok Build in your project, it reads the scaffolded AGENTS.md file. This file points Grok Build to the documentation for your project's Expo SDK version and holds any project-level instructions you add.

AGENTS.md is committed to your project, so a developer's Grok Build session starts from the same context.

Example prompts

After setup, describe Expo tasks in plain language. For example:

TaskExample prompt
Upgrade the SDKUpgrade this project to the latest Expo SDK and fix any breaking changes.
Add navigationAdd a tab navigator with Expo Router and a new settings screen.
Automate buildsCreate a workflow with Expo Workflows that builds the app on every pull request.
Debug a buildMy latest iOS build failed. Read the Expo Build logs and tell me what went wrong.
Add notificationsConfigure expo-notifications and show a local notification when the app launches.
Set up CI/CDCreate a CI/CD workflow that builds on every PR.
Add native UIAdd a SwiftUI picker component to my Expo app.
Check feedbackShow TestFlight feedback for my app.
Verify the UITake a screenshot and verify the blue circle view.

For more examples, see the Example prompts sections of Expo Skills and Expo MCP Server.