Skip to main content

GitHub

GitHub Integration​

Integrating GitHub with your Ideavo project provides full version control, collaborative workflows, and code portability throughout your app’s lifecycle.

  • Git: A version control system that tracks changes in your code.
  • GitHub: The industry-standard platform for hosting Git repositories and managing changes- ideal for solo builders and teams using Ideavo.
  • By linking your project to GitHub, every change in your Ideavo app is mirrored to a Git repository in real time. You gain a complete history of your code, familiar collaboration workflows, and the freedom to host or deploy outside Ideavo if needed.
  • GitHub integration brings transparency, safety, and flexibility to your development process.

Key Benefits​

  • Version History & Backup - All code is tracked with Git. You can review diffs, revert to previous states, and rely on GitHub as an external backup of your project.
  • Team Collaboration - Your code lives on GitHub, enabling reviews, comments, and contributions via pull requests. Non-technical stakeholders can also view history for transparency.
  • Real-Time Sync - Ideavo and GitHub stay aligned automatically. Push to GitHub and Ideavo pulls changes; edit in Ideavo and changes are pushed to GitHub- no manual syncing required.
  • Workflow Integration - Use branches, pull requests, issues, and CI/CD (e.g., GitHub Actions) alongside Ideavo. Run tests or deploy on merge while continuing to build with Ideavo’s editor and AI.
  • Deployment Flexibility - You’re not locked into Ideavo’s hosting. Export and deploy anywhere; Ideavo will continue syncing code with GitHub so you can keep building in Ideavo.

Connecting Ideavo to Your GitHub Account​

  1. Click the GitHub icon (top-right) to begin authorization.
  2. In the popup, click Connect.
  3. Authorize Ideavo on GitHub:
  4. Sign in to GitHub (if needed).
  5. Review requested permissions.
  6. Grant access to all repositories or specific repositories.
  7. Click Authorize Ideavo.
  8. Once authorized, Ideavo can create a new repository for your project in your personal account or organization.
  9. Finally, Click on Github icon and then on "Connect Project" to connect ideavo project to github repository.

How Syncing Works (Ideavo ↔ GitHub)​

Default Branch Only​

Ideavo tracks your repository’s default branch (typically main or master). Changes on other branches appear in Ideavo only after they’re merged into the default branch. Ideavo also pushes its changes to the default branch.

Real-Time Updates from GitHub​

Commits pushed to the default branch appear in Ideavo almost immediately. Ideavo listens for changes and fetches the latest commit before the next prompt executes (you may refresh the dev server or continue in chat to pull).

Pushing Changes from Ideavo​

Edits made in Ideavo (via Code Editor or AI-generated code) are committed to the backing Git repository and automatically pushed to GitHub. Treat Ideavo like another Git client.

No Manual Pull/Push Needed​

Sync is continuous and bidirectional. If something seems out of sync, refresh Ideavo or check the GitHub repo; otherwise, no action is required.

Conflict Handling​

In an edge case if simultaneous edits are made on both Ideavo and Github master branch, Ideavo prefers the local state over github changes.

Summary: Your Ideavo project and the GitHub repo are effectively the same source of truth, mirrored in real time.

Importing an Existing GitHub Repository into Ideavo​

Currently, Ideavo does not support directly importing an external GitHub repo as a new project.

Workarounds:

  1. Manual Import via New Repo Create a new Ideavo project and connect it to GitHub (creating a new repo). Locally clone that repo, copy your existing code into it, then commit and push to the default branch. Ideavo will sync and display the files.
  2. Copy–Paste for Smaller Codebases For small projects or modules, start a new Ideavo project and paste files or snippets into the editor/AI prompts.
tip

Planned Feature: Direct repo import is under consideration for future updates.