Connect your existing GitHub repository to TurtleApps for AI-powered development in your own codebase. This guide covers the setup process and best practices.

Prerequisites

A GitHub account with repository access
TurtleApps Professional plan or higher
Repository with at least one branch

Connecting GitHub

Install GitHub App

Go to Settings → Integrations → GitHub and click "Connect GitHub". You'll be redirected to GitHub to install our app.

GitHub integration button

[Screenshot placeholder]

Select Repositories

Choose which repositories TurtleApps can access:

All repositories — Access all current and future repos
Select repositories — Choose specific repos only

✨Least Privilege

We recommend selecting only the repositories you need. You can always add more later.

Link to Project

Back in TurtleApps, go to your project settings and select the connected repository from the dropdown.

Required Permissions

TurtleApps requires the following GitHub permissions:

Permission	Purpose
Contents (Read & Write)	Read code and commit changes
Pull Requests (Read & Write)	Create and update PRs
Metadata (Read)	Access repo information
Webhooks (Read & Write)	Receive push notifications

Repository Structure

For best results, your repository should have:

Recommended structure

my-project/
├── src/           # Source code
├── package.json   # Dependencies (Node.js)
├── .gitignore     # Ignored files
├── README.md      # Project documentation
└── .env.example   # Environment variables template

Branch Strategy

TurtleApps works with your existing branch strategy:

Default Behavior

AI creates a new branch from your default branch
Changes are committed to the feature branch
A pull request is created automatically
After approval, the PR is merged

Branch Naming

AI-created branches follow this pattern:

turtle/ticket-123-add-contact-form

💡Custom Prefix

You can change the branch prefix in Project Settings → Repository → Branch Prefix.

Repository Verbinden