Connect to GitHub

Sync your RubyOnVibes project to a GitHub repository.

Prerequisites

You need an active subscription to sync your code to GitHub. View plans if you haven't subscribed yet.

Step-by-Step Setup

Everything starts from the History panel — click the clock icon in the upper-right toolbar (on mobile, tap the hamburger menu first).

1. Sign in with GitHub

In the History panel, click Sign in with GitHub. This takes you to the Connected Accounts page where you can link your GitHub account. Once connected, head back to the History panel on your project.

2. Create a repository on GitHub

If you don't already have a repo for your project, create one at github.com/new. It can be public or private — your choice.

3. Connect your repositories

Back in the History panel, click Connect Repositories. This lets you grant access to the repositories you want to use with Ruby on Vibes. Select the repo you created (or choose "All repositories" if you prefer).

4. Select a repository

Click Select Repository in the History panel. Choose the repo you want to sync your project to, then click Connect Repository.

5. Sync your code

Click Sync now to push your code and full git history to GitHub. Your code lands on a rubyonvibes branch by default.

Future Syncs

Whenever you want to sync your latest changes, open the History panel and click Sync now again. Each sync merges changes in both directions — your platform edits go to GitHub, and any GitHub commits come back to the platform.

Two-Way Sync

Sync works in both directions. You can develop on the platform and push to GitHub, or develop locally (or with any tool) and push to GitHub — then sync those changes back to the platform.

Develop locally, sync back to the platform

  1. Clone your repo from GitHub
  2. Make changes locally and push to the rubyonvibes branch
  3. Back on the platform, click Sync now in the History panel — your local changes are merged in

Automatic sync on push

You can enable automatic pull so the platform picks up your GitHub pushes without clicking Sync now:

  1. In the History panel, toggle Enable pull from GitHub
  2. Optionally enable Auto-deploy to automatically deploy when new changes arrive from GitHub

When enabled, every push to your rubyonvibes branch on GitHub automatically syncs to the platform and (if auto-deploy is on) deploys your updated app.

Merge conflicts

If changes on the platform and GitHub conflict, the sync will pause and show you which files are conflicted. You can:

  • Resolve and retry — fix the conflicts and sync again
  • Force push — overwrite the GitHub branch with the platform version

What Gets Synced

  • All your project files
  • Full git history
  • Syncs to the rubyonvibes branch by default

Next Steps

Once your code is on GitHub, you can clone the repo and run it locally, hand it to any developer or coding agent, or deploy it anywhere. With two-way sync, any changes you push to GitHub flow right back into the platform.