Learn how to connect Builder Projects to your Azure account using a Personal Access Token (PAT).
Once your account is connected, design visual changes within Builder and then share your AI assisted code with your team through a pull request.
To create a new personal access token:
- Login to your Azure DevOps organization.
- Go to User Settings followed by Personal access tokens.
- Click + New Token.
- Provide a name for your token, such as Builder.io.
- Select the scopes detailed below for the access token.
✓ Build - Read & Execute
✓ Code - Read & Write
✓ Pull request threads - Read & writeFinally, copy the generated PAT string for the next step of the process.
To connect your Builder account to Azure DevOps:
- On the Projects page, click the down arrow next to Connect Repo.
- Choose the Azure DevOps option.
- On the following screen, enter your Azure organization's name and paste your PAT. Note that the organization name is as it is set in Azure in the Create a new personal access token dialogue. In the video below, the organization is
my-example-org. In Builder, the user enters onlymy-example-org(at 30 seconds in the video), with no leading URL. So the organization name ismy-example-org, nothttps://dev.azure.com/my-example-org. - Click Connect Azure DevOps.
Builder is now connected to Azure. You are then prompted to choose a specific repository for your Project.
For more details on connecting to a specific repository, visit Connecting an existing repo.
To create a net-new application from an existing repository:
- Go to the Projects page in the Builder app.
- Click the Connect Repo button, or click the down arrow to choose your version control platform.
- Choose an application from your linked repositories.
- Select Setup Visual Editing.
- Typically, you should select Start Auto Setup. If your application lacks configuration files or has a particularly complicated setup process, select Use Manual Setup.
- Builder's AI searches for configuration files and sets up your Project for you. In the meantime, add environment variables to the form on the right, if applicable.
- Click the Finish Setup button. This brings you to Builder's Visual Editor where you can prompt the AI for changes to your Project.
Was this article helpful?