Skip to main content
Already have code on GitHub? Maybe a web app, a prototype, or a project from another AI builder? You don’t have to start from scratch. Rork can import a GitHub repository, inspect the actual source files, and continue building from there as a native mobile app.

​
Two ways to import

Both use GitHub Sync: Rork stays connected to the repository, so it reads your real source files instead of guessing from screenshots or descriptions.

​
Start a new project from a GitHub repo

​
1. Click “GitHub to Mobile App”

On rork.com, under the prompt box, click GitHub to Mobile App.
Import buttons under the prompt box on the Rork homepage

​
2. Paste the repository URL

The dialog “Create an app from GitHub with Rork” opens. Paste your repository URL (https://github.com/owner/repo).
The GitHub import dialog with a repository URL pasted

​
3. Generate the app

  • Generate app now starts immediately, or
  • I have extra requests attaches the repo to your prompt so you can add instructions (“import this and make the dashboard the home screen”).
The repository is attached to the prompt as a GitHub Sync source, and Rork creates the project.
A new project created from a GitHub repository, with the GitHub Sync source attached

​
4. Grant access via the Rork GitHub App

GitHub Sync works through the Rork GitHub App, so the app needs access to the repository you’re importing. The agent guides you through it right in the chat:
  1. If the app isn’t installed yet, click Open GitHub in the chat widget and install it.
  2. If the app is installed but can’t see this repository, click Update GitHub permissions and add the repo (you can limit access to just that one repo).
  3. Back in Rork, click I’ve updated permissions / Retry, then Continue to confirm.
The status line shows “Connected owner/repo” when the link is live.
The repository must live in a GitHub account or organization where you can install the Rork GitHub App. To import someone else’s public repository, fork it to your account first and import your fork.

​
5. The agent rebuilds your app from the source

Once connected, the agent scans environment variables, audits the source (screens, patterns, theme, integrations), scaffolds the native app, and reproduces your product, reusing your real assets straight from the repo:
Rork's task list while importing a repository
A few minutes later the app is running in the cloud simulator, rebuilt natively from your repository:
An app imported from GitHub running natively in the Rork simulator

​
Import a repo into an existing project

Inside any project, paste a GitHub URL in the chat and ask the agent to connect it, for example:
The agent links the repository to your project (it stays attached across sessions), so it can read the code, reuse your API contracts and data models, and keep everything consistent with the source.

​
Keep the sync two-way

GitHub Sync is not a one-time copy. When new commits land in the connected source repository, the project notifies you and you can pull them in with one click:
The GitHub Sync notification: new changes are available, Sync now
And by connecting your Rork project to its own GitHub repository you get full two-way sync:
  • Every change Rork makes is pushed to GitHub.
  • Commits you push from your editor are imported back into Rork.
To set it up from a project: ⋯ menu → GitHub → Connect.
The GitHub two-way sync option in the project menu
See the full walkthrough: How to sync your project with GitHub.

​
What kinds of repos work best?

  • Web apps (React, Vue, Next.js, anything with readable source): Rork rebuilds the product as a native mobile app.
  • Output of other AI builders (Lovable, Bolt, v0, Replit, and others): see Import from any app builder.
  • Expo / React Native projects: Rork understands them natively, see Convert between platforms.
  • Backends / APIs: connect them as a source so your mobile app matches the API exactly.

​
FAQ

​
Does importing change my repository?

No. Importing reads your code. Rork only pushes to a repository if you explicitly connect two-way sync for the project, and that’s a separate repository that Rork creates (or one you choose).

​
Can I import a monorepo?

Yes. Mention which folder or app inside the monorepo you care about in your prompt so the agent focuses on the right code.

​
The repo isn’t found or access fails

  • Check the URL is https://github.com/owner/repo (no .git suffix needed, branches and subfolders can be mentioned in your prompt).
  • For private repos, make sure the Rork GitHub App is installed on the account/organization that owns the repo, with access to that specific repository.