GitHub Integration

Integrations • GitHub Integration

GitHub Integration with biela.dev


Connecting your GitHub account to biela.dev allows you to automatically sync, commit, and deploy your projects directly from your workspace. Once connected, biela.dev can push your generated code, documentation, and updates to your GitHub repositories — keeping your projects organized and version-controlled.

Why Connect GitHub

Integrating GitHub with biela.dev gives you:

  • Automatic code commits every time you update your project.
  • Repository sync to keep your local and online versions aligned.
  • Collaboration with your teammates via GitHub’s workflow.
  • Deployment-ready repositories, so you can push straight to your hosting or CI/CD pipeline.


This setup ensures every project you create in biela.dev is stored safely in your GitHub account, ready for further development or publication.


Connecting GitHub to Your biela.dev Account

Follow these steps to connect GitHub with your biela.dev workspace:

1. Open your Project

  • Log into biela.dev
  • From your dashboard, select the project you want to connect.
  • Click Settings in the project’s sidebar.



2. Start the GitHub Connection


In the Settings tab, locate the Integrations section.
  • Click Connect GitHub.


You’ll see two connection options:

  • Connect GitHub OAuth
  • Connect GitHub App


Let’s go through both options.


Option 1: Connect GitHub OAuth

This method uses GitHub’s OAuth authentication to securely link your account.
  1. Click Connect GitHub OAuth.
  2. You’ll be redirected to GitHub’s authorization page.
  3. Grant access to biela.dev by confirming the permissions requested.
  4. Once authorized, return to biela.dev.
  5. Click your profile in the top-right corner, then go to User Dashboard.
  6. Open your project again and return to Settings → Connect GitHub.
  7. You should now see a confirmation message indicating your GitHub account is linked.



Option 2: Connect GitHub App (Recommended)

For full integration, including repository management and automatic commits, we recommend connecting via the GitHub App.


1. Go to Settings → Connect GitHub.

2. Click Connect GitHub App.

3. A new window will open showing your available GitHub accounts and organizations.

4. Select the account or organization you want to connect.

5. Choose the repositories you’d like biela.dev to access:

  • Select All repositories if you want complete access, or
  • Choose Only selected repositories for specific projects.
6. Click Save to confirm.
7. Once completed, you can close the tab and return to biela.dev.



3. Verify the Connection


Back in biela.dev:
  1. Go to Settings → Connect GitHub again.
  2. You should now see a message confirming that your GitHub App is connected.
  3. If successful, the button label will now show Disconnect GitHub App — meaning the integration is active.



4. Test the Integration


To make sure everything works:

  1. Open your project’s main dashboard.
  2. Make a small update (e.g., change a file or generate a component).
  3. biela.dev will automatically commit the change to your connected repository.
If you open GitHub, you should see your new commit appear under your chosen repository.



Why Connect GitHub

Integrating GitHub with biela.dev gives you:
  • Automatic code commits every time you update your project.
  • Repository sync to keep your local and online versions aligned.
  • Collaboration with your teammates via GitHub’s workflow.
  • Deployment-ready repositories, so you can push straight to your hosting or CI/CD pipeline.


This setup ensures every project you create in biela.dev is stored safely in your GitHub account, ready for further development or publication.




Troubleshooting


If the GitHub connection doesn’t appear immediately:
  • Refresh the biela.dev page after connecting the app.
  • Reopen your project and check the Settings → GitHub section again.
  • Make sure you’re logged into the same GitHub account you connected.
  • If you still don’t see the integration, disconnect and reconnect your GitHub App.



Disconnecting GitHub


If you want to unlink GitHub:

  • Go to Settings → Connect GitHub.
  • Click Disconnect GitHub App.
  • Confirm the disconnection.

You can reconnect anytime using the same steps above.




Next Steps


Once GitHub is connected, you can:

  • Enable auto-commit for your generated code.
  • Sync your project documentation with your GitHub Wiki.
  • Deploy your app using GitHub Actions, Vercel, or Netlify integrations.


Tip


If you plan to work with multiple projects or teams, connect your organization-level GitHub App to streamline collaboration and automate version control across all your biela.dev projects.

Article 1 of 4 in Integrations