Skip to main content

GitHub integration

Automatic version control for all your projects.

Overview​

Every Appifex project gets a GitHub repository with:

  • All generated code
  • Automatic commits on changes
  • Branch management (Coder mode)
  • Webhook sync for external changes

Connecting GitHub​

First time setup​

  1. Go to Settings in Appifex
  2. Click Connect GitHub
  3. Authorize the Appifex GitHub App
  4. Choose repository access level

Access levels​

LevelWhat it allows
Public repos onlyAppifex creates public repositories
All repositoriesCreate public or private repos

Automatic features​

Repository creation​

When you create a project:

  • New repo created automatically
  • Named after your project
  • Includes README with project info

Commits​

Every change is committed:

  • Code generation → Commit
  • File edits → Commit
  • Deployments → Tagged

Webhooks​

Appifex registers webhooks to track:

  • Push events (detect external commits)
  • Pull request events (track PR lifecycle)
  • Branch deletion (clean up sessions)

Working with branches​

Builder mode​

All changes go to main:

main ← All your commits

Coder mode​

Each session creates a branch:

main
├── session/feature-auth
├── session/mobile-app
└── session/redesign

Two-way sync​

Appifex → GitHub​

Changes in Appifex push automatically.

GitHub → Appifex​

  1. Edit code locally or in another tool
  2. Push to your branch
  3. Appifex detects the change via webhook
  4. Continue building with updated code

Common workflows​

Clone and edit locally​

git clone https://github.com/your-username/your-project.git
cd your-project
git checkout session/your-branch
# Make changes
git push

View on GitHub​

Click the GitHub icon in your project to open the repository.

Create PR manually​

If you prefer GitHub's PR interface:

  1. Push your branch
  2. Go to GitHub
  3. Create PR normally
  4. Appifex tracks the PR status

Troubleshooting​

Can't see repository​

  1. Check GitHub connection in Settings
  2. Verify the repository exists
  3. Try reconnecting GitHub

Push failed​

  1. Check your GitHub permissions
  2. Ensure branch isn't protected
  3. Verify network connection

Webhook not working​

  1. Go to repo Settings → Webhooks
  2. Check webhook is registered
  3. Verify recent deliveries

Best practices​

Use meaningful commit messages​

Appifex generates descriptive commits, but you can also commit manually with your own messages.

Keep main stable​

In Coder mode, merge only tested features.

Review before merging​

Use GitHub's PR review features for team projects.