- List and read repositories, branches, and file contents
- Create and update issues and pull requests
- Read commits, releases, and workflow runs
- Build internal tools and automations on top of GitHub data
This is a connector for apps you build with Lovable. Your app can call the GitHub REST API to read and update repositories, issues, pull requests, and other GitHub data.
Want to export or two-way sync your Lovable project code to GitHub instead? Use GitHub Git sync.
Common use cases and example apps
| Example app | Example prompt | Description |
|---|---|---|
| Issue triage board | Use GitHub and build a dashboard that lists open issues across my repositories, grouped by label. | Surface open work without leaving your app. The app reads issues from GitHub and presents them in a filterable board. |
| PR status hub | Use GitHub and build a page that shows open pull requests with review status and age. | Give managers a live view of in-flight code review. The app fetches pull requests and highlights stale or blocked reviews. |
| Release tracker | Use GitHub and build a tool that lists recent releases and workflow results for our main repos. | Track shipping activity from GitHub data. The app combines release and Actions metadata in one view. |
| Repo health dashboard | Use GitHub and build an admin page that shows repository stats and open issue counts. | Monitor repository health at a glance. The app aggregates GitHub API responses into summary cards. |
| Automation webhook companion | Use GitHub and build a server endpoint that creates an issue when a form is submitted. | Turn app events into GitHub issues automatically. The app validates input and calls the GitHub REST API through the connector gateway. |
| Contributor activity feed | Use GitHub and build a page that shows recent commits and pull requests across our team repositories. | Give stakeholders a single view of recent engineering activity. The app fetches commits and pull requests and groups them by repository or author. |
How to connect GitHub
Workspace admins and owners can connect GitHub. You can create multiple GitHub connections using different personal access tokens, which is useful for separating environments (for example, development and production) or using tokens with different permission scopes. When the connection is created, GitHub becomes available across all projects in the workspace. Anyone building in a project can ask Lovable in chat to link their project to it.Prerequisites
Before connecting GitHub, make sure you have:- A GitHub account
- A personal access token with permissions that match the endpoints your app will call
- Lovable workspace owner or admin role
API requests made through this connector count toward your GitHub account rate limits. Quotas and billing are handled by GitHub, not Lovable.
Step 1: Create a GitHub personal access token
A personal access token lets your Lovable app authenticate with the GitHub REST API on your behalf. To create a GitHub personal access token:Open GitHub token settings
Sign in to GitHub and open Settings → Developer settings → Personal access tokens.
Generate a token
Create a fine-grained or classic token. Fine-grained tokens can be limited to specific repositories. Classic tokens use scope lists such as
repo or public_repo.Select permissions
Grant only the permissions your app needs. For private repositories, include repository read or write access. For public data only,
public_repo may be enough on classic tokens.Step 2: Connect GitHub to Lovable
You can create multiple connections using different personal access tokens.Configure the connection
- Display name: name the connection, for example
GitHub Prod. - Personal access token: paste the token you created in step 1.
Choose who can access this connection
Under Who can access this connection, decide who in your workspace can use the connection:
- Only you (default): only the person creating the connection can use it and its associated data.
- Invite specific people: only you and explicitly added workspace members can use the connection and its associated data.
- Invite entire workspace: click Invite entire workspace to make the connection available to everyone in your Lovable workspace.
Limitations
The GitHub connector cannot:- Use OAuth app or GitHub App installation flows. Use a personal access token instead.
- Replace GitHub Git sync for backing up or syncing your Lovable project codebase.
- Support per-end-user GitHub login. Each connection represents a single GitHub account shared across all projects linked to it.
- Call endpoints your token permissions do not cover. If a call returns
403, update the token permissions or create a new token with broader scopes.
How to unlink projects from a connection
Editors and above can remove specific projects from a connection without deleting the connection entirely. The connection will remain available for other projects. To unlink projects:
When unlinked, those projects will no longer have access to through this connection. If a project needs again, you can link it to any available connection.