Skip to main content

GitHub integration

Every Appifex project includes automatic GitHub version control.

What you get​

  • Automatic repository creation - New repo for each project
  • Version history - Every change is committed
  • Branch management - Feature branches in Coder mode
  • Two-way sync - Edit in Appifex or your IDE

Connecting GitHub​

  1. Go to Settings in your Appifex dashboard
  2. Click Connect GitHub
  3. Authorize Appifex
  4. Select repository access (public or all repos)

Repository structure​

Appifex creates organized repositories:

your-project/
├── web/                 # React web application
├── mobile/              # React Native mobile app
├── backend/             # Python FastAPI backend
├── .github/             # GitHub Actions (if configured)
└── README.md            # Auto-generated documentation

Working with branches​

Builder mode​

All changes commit directly to main:

main ← Your changes go here

Coder mode​

Each session creates a feature branch:

main
├── session/feature-auth
├── session/mobile-redesign
└── session/api-v2

Two-way sync​

Edit in Appifex​

  1. Make changes in Appifex
  2. Automatically pushed to GitHub
  3. Continue in your IDE if needed

Edit externally​

  1. Clone your repo locally
  2. Make changes in VS Code, Cursor, etc.
  3. Push to GitHub
  4. Appifex detects changes via webhook
  5. Continue building in Appifex

Pull requests​

In Coder mode, create PRs directly from Appifex:

  1. Click Create pull request
  2. Review your changes (diff view available)
  3. PR opens on GitHub
  4. Merge when ready
  5. Session marked as merged

Webhooks​

Appifex registers webhooks to track:

  • Push events - Detect external commits
  • Pull request events - Track PR lifecycle
  • Branch deletion - Clean up merged sessions

Best practices​

Use meaningful session names​

When creating sessions in Coder mode, use descriptive names:

  • add-user-authentication
  • redesign-dashboard
  • fix-mobile-navigation

Review before merging​

Use the diff view to see all changes before creating a PR.

Keep main stable​

In Coder mode, test in feature branches before merging.

Troubleshooting​

Repository not syncing​

  1. Check GitHub connection in Settings
  2. Verify webhook is registered
  3. Re-authorize if needed

Permission errors​

Ensure Appifex has access to the repository:

  1. Go to GitHub → Settings → Applications
  2. Find Appifex
  3. Grant repository access