Prerequisites
- A GitHub account
- Your app’s code in a GitHub repository (public or private)
- An Nometria account
Connect your repository
1
Open New Migration
Go to nometria.com/dashboard and click New Migration.
2
Select GitHub
Choose Connect via GitHub from the connection method screen.
3
Authorize Nometria
Click Authorize with GitHub. You’ll be redirected to GitHub to grant Nometria access.Nometria requests:
- Read access to your repository contents and metadata
- Write access to create branches and commit (for two-way sync)
- Pull request permissions (for two-way sync merge flow)
You can grant access to all repositories or only selected ones. Selecting specific repositories is recommended.
4
Pick your repo and branch
Select the repository from the dropdown. Choose the branch to deploy from — typically
main or master.What Nometria reads from your repo
Nometria auto-detects your stack by inspecting:
If detection is wrong, you can override it on the configuration screen.
Monorepos
If your repository is a monorepo (e.g.apps/frontend + apps/backend):
- On the configuration screen, set the App root to your frontend package path (e.g.
apps/frontend) - Set the API root if your backend is in a separate folder (e.g.
apps/backend) - Nometria deploys both and wires the API proxy automatically
Two-way sync with GitHub
Once connected, you can enable two-way sync so changes from your vibe coder are automatically pushed back to the same repository and deployed.Two-Way Sync overview
Learn how builder changes and developer changes coexist in the same repo.
Permissions and security
Nometria uses a GitHub App (not OAuth tokens) for repository access. This means:- Access is scoped per-repository, not account-wide
- You can revoke access at any time from GitHub Settings → Applications
- Credentials are never stored — all operations use short-lived installation tokens