Skip to main content

GitHub integration

Every project gets its own GitHub repository. Appifex creates it, commits to it after every generation, and syncs changes both ways.

You are never locked in. The code is yours. In user mode, the repo lives in your GitHub account. In platform mode, Appifex manages it with an option to transfer ownership.

What happens automatically​

  • Repo creation -- A new repository for each project
  • Auto commits -- Every code change is versioned
  • Branch management -- Feature branches in Coder mode
  • Two-way sync -- Edit in Appifex or your IDE, changes sync both ways

Setup​

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

Branches​

Builder mode​

All changes commit directly to main.

Coder mode​

Each session creates a feature branch with a UUID:

main
├── session/a1b2c3d4-e5f6-7890-abcd-ef1234567890
├── session/b2c3d4e5-f6a7-8901-bcde-f12345678901
└── session/c3d4e5f6-a7b8-9012-cdef-123456789012

Create a pull request when you're ready for review. Merge on GitHub, and the session marks as complete.

Two-way sync​

Appifex -> GitHub: Changes push automatically when you generate or edit code.

GitHub -> Appifex: Push from your local IDE, and Appifex picks up the changes. Continue building with full context.

# Clone and edit locally
git clone https://github.com/your-username/your-project.git
git checkout session/a1b2c3d4-e5f6-7890-abcd-ef1234567890
# Make changes in VS Code, Cursor, etc.
git push
# Return to Appifex and keep going