Bring Your Own Repo

​

Why bring your own repo?

• Edit anywhere, stay in sync — Make changes in your IDE, Stably’s web editor, or CLI—everything syncs to the same repository automatically
• Existing tests & rules — Already have Playwright tests, custom configurations, or team conventions? Stably works with what you have

​

How it works

• New Stably Project
• Existing Stably Project

If you’re creating a new Stably project and want to connect your repository from the start:

1

Install the GitHub App

Click Install GitHub App to authorize Stably to access your repositories.

2

Configure your repository

Select your repository and configure the connection settings:

Configuration settings

• Repository — Select the GitHub repository to connect
• Branch — Choose the branch to sync with (e.g., main, develop)
• Working Directory — Relative path from repo root where tests live (e.g., tests/e2e). Leave empty for repo root. Stably auto-detects existing playwright.config files.
• Package Manager — Select your package manager: npm, pnpm, yarn, or bun
• Publish Behavior — Choose how changes are published:
  • Create Pull Request — Creates a PR for review before merging
  • Push to main branch directly — Pushes changes directly to the main branch

3

Start testing

Create tests with the web editor or CLI—they all sync to your repository automatically.

If you already have a Stably project and want to connect your own repository:

1

Switch to Agent 2.0

Make sure your project is using Agent 2.0. You can check this in your project settings.

2

Export your tests

Go to Settings > Git to export your existing tests. This creates files you can import into your own repository.

3

Install the GitHub App

Click Connect my repo and follow the instructions to install the GitHub app.

4

Connect your repository

Select your repository and configure the connection settings:

Configuration settings

• Repository — Select the GitHub repository to connect
• Branch — Choose the branch to sync with (e.g., main, develop)
• Working Directory — Relative path from repo root where tests live (e.g., tests/e2e). Leave empty for repo root. Stably auto-detects existing playwright.config files.
• Package Manager — Select your package manager: npm, pnpm, yarn, or bun
• Publish Behavior — Choose how changes are published:
  • Create Pull Request — Creates a PR for review before merging
  • Push to main branch directly — Pushes changes directly to the main branch

5

Start testing

Your tests now sync to your repository. Create tests with the web editor or CLI—they all sync automatically.

​

Compatibility

• Git provider: GitHub (GitLab support coming soon)
• Works with any web application — Supports React, Angular, .NET, and any backend framework (e.g., Python, Rust). Our tests simulate real user behavior, so we’re technology agnostic.

​

Next steps