RevloBetaDocs
    Back
    GitHub Integration

    GitHub Integration

    Connect your GitHub account via OAuth to push generated code to repositories and create new projects.

    Authentication MethodOAuth 2.0

    Revlo uses GitHub OAuth to securely connect to your GitHub account. This provides a better user experience than personal access tokens and follows GitHub's recommended authentication flow.

    How to Connect

    1. Navigate to /integrations in your Revlo dashboard
    2. Find the GitHub integration card and click Configure
    3. You'll be redirected to GitHub to authorize Revlo
    4. Review the requested permissions and click Authorize
    5. You'll be redirected back to Revlo with GitHub connected successfully
    No setup required

    Revlo uses OAuth, so you don't need to create any GitHub tokens or apps. Just click and authorize!

    Features

    Push to Existing Repos

    Push your generated project files to an existing GitHub repository. Revlo creates a commit with all your workspace files.

    Create New Repositories

    Create new GitHub repositories directly from Revlo. Choose between public or private visibility.

    Automatic File Sync

    All files in your workspace are automatically pushed to GitHub with proper formatting and normalization.

    Deployment Integration

    GitHub integration is required for deploying to Netlify and DigitalOcean, which build directly from GitHub repositories.

    How to Use

    1. Create or open a project
      Navigate to your project workspace where you've generated code.
    2. Click "Push to GitHub"
      Find the button in the workspace toolbar or actions menu.
    3. Configure repository details
      • Choose to create a new repository or push to an existing one
      • If creating new: set repository name and visibility (public/private)
      • If pushing to existing: select the repository and branch
    4. Push your code
      Revlo will commit all your workspace files to the specified repository.

    Troubleshooting

    OAuth connection fails

    If you see an error during OAuth connection:

    • Try using a different browser or clearing your cookies
    • Make sure you're logged into the correct GitHub account
    • Try disconnecting and reconnecting the integration from the Integrations page
    Push to repository fails

    If pushing to a repository fails:

    • Verify that the GitHub integration is active in /integrations
    • Make sure you have write access to the target repository
    • For private repositories, ensure the OAuth token has repo access
    • Try disconnecting and reconnecting the GitHub integration
    Repository access denied

    If you get an access denied error:

    • Check your GitHub account permissions for the repository
    • For organization repositories, ensure Revlo's OAuth App is approved by the org
    • Go to GitHub → Settings → Applications and verify Revlo has access
    Ready to connect GitHub?
    Head to the Integrations page to get started.
    GitHub OAuth Docs Open Integrations