Skip to main content

GitHub Integration

AppX generates real, inspectable Expo + React Native code — and on Premium and Pro plans you can keep that code in a GitHub repository with 2-way sync. Edits you make in AppX flow to GitHub, and changes pushed to GitHub flow back into your project.

This is the bridge between "describe it in chat" and "my engineering team works in their own tools."

What you can do​

  • Push to GitHub — sync your project to a repo so your code lives in version control
  • Pull changes back — bring edits made by external developers into AppX
  • Work both ways — designers and PMs iterate in AppX chat; developers commit in GitHub; everyone stays in sync
  • Standard Expo project — the repo is a normal, runnable Expo app you can clone and start locally

Connecting a repository​

  1. Open your project
  2. Go to Project Settings → GitHub
  3. Connect GitHub and authorize AppX
  4. Choose to create a new repository or link an existing one
  5. AppX pushes your current project to the repo

From there, syncing runs both directions so AppX and GitHub stay aligned.

What the repo looks like​

Your project exports as a standard Expo app you can clone and run with npx expo start:

app/                   <- Expo Router screens
components/            <- Reusable components
constants/            <- Colors, typography, spacing
hooks/                <- Custom hooks
assets/               <- Fonts, images
app.json              <- Expo config
package.json          <- Dependencies
tsconfig.json         <- TypeScript config

Because it's a plain Expo project, it works with the rest of your toolchain — GitHub Actions, pull requests, code review, and any CI you already run.

A note on secrets​

Your environment variables stay in AppX and are not written to the GitHub repo. If a teammate clones the repo to run it locally, they'll supply their own values for sensitive keys. Document the variable names (not values) in your README so others know what to set.

tip

On Starter you can export your project as a ZIP for a one-time download. GitHub's continuous 2-way sync is a Premium and Pro feature.

Environment Variables

Keep secrets out of your repo.

Publishing

Ship to the App Store and Google Play.

Plans & Pricing

GitHub sync is Premium and Pro.