Builder Projects provides a way to create and iterate on applications using AI and visual editing. Prototype ideas, build new web applications, or convert Figma designs to code.
Once your Project is connected to a repository, create pull requests directly from Builder with the click of a button.
A pull request is a series of changes made to existing code. These changes are packaged up in a pull request, which can then be reviewed and changed by other members of your team.
When you edit a Project that is configured for using pull requests, you'll create a branch. A branch is a copy of the codebase at the current moment. Branches allow you and others on your team to work on the same codebase simultaneously.
When you click the Send PR button in a Project, Builder creates a pull request with only the changed code. Software developers on your team can then review and run the changes locally and investigate the generated code.
To push code from one of your Projects, you must have a connection to your organization's version control system.
For more information on what systems Builder supports and how to set this up, visit Projects Setup overview.
To create branches and pull requests from your Project, you must first ensure your Project has enabled them.
To enable branching and pull requests for your Project:
- On your main Projects page, click the three-dot menu for your Project.
- Choose Project Settings.
- Go to the Advanced tab.
- Under Commit Mode, choose the Pull Requests option.
- Click Save.
You should now see that you can create a new branch. Use the + New Branch whenever you create new features.
By default, when using the + New Branch button, the created branch uses your main branch as its base.
To enable other remote branches to be used as the base branch for your Project:
- On your main Projects page, click the three-dot menu for your Project.
- Choose Project Settings.
- Scroll down to the Main Branch Name section.
- Select the option enabling base branch selection when creating new branches.
- Click Save.
Now when you click + New Branch, you are prompted to first choose your base branch.
To refine your application:
- Go to the prompt field embedded on the left, within the Chat tab.
- Write a new prompt specifying what you'd like changed.
- Click Enter.
Builder immediately begins to apply the changes.
For example, the following prompt would lead to Builder adding a reminder banner to the top of the page with some specific details.
Include a small banner to the top of the page, reminding
users when they need to RSVP by.Without much guidance, Builder does its best to fulfill your request. For more fine-grained control, switch to Design mode or Import from Figma.
To create a pull request after making changes to your Project, click the Send PR button. After clicking, Builder generates the pull request and then opens a new tab, directing you to your pull request.
Share your pull request with your team to get feedback and potentially merge your changes into your live application.
After sending a PR, you can continue to make adjustments to your Project branch. Use the Update PR button whenever changes are made to update your remote pull request with changes from Builder.
Alternatively, enable the Auto-push feature. Doing so automatically pushes changes made by Builder to your remote pull request. Enable Auto-push by clicking PR button within the Visual Editor, then clicking the Auto-push toggle.
Quickly sync your remote repository with your Project branch. This helps ensure you have the most up-to-date code before continuing to work on your Project branch changes.
If you are having issues pushing your branch, it may be because your Project and remote repository are out of sync. This step can also solve those issues.
To sync changes from your remote repository:
- Within a Project, click the three-dot menu.
- Choose the Sync from GitHub option. Depending on your remote repository provider, the text may differ slightly.