Why do the Amplify docs say it creates new branches for every PR?

Question

In the AWS Amplify docs, it says:
> "When EnableAutoBranchCreation is set to true, Amplify will automatically create a new branch in your app's connected Git repository whenever a new pull request is opened."

A developer has to create a branch BEFORE they create a pull request in the first place. Why would Amplify then create _another_ branch? What's the point of this?

What I actually want is for Amplify to detect PRs and just deploy the contents of that branch (like Vercel or Netlify). I don't want extra branches being created. Is this possible?

Answer

You're right that GIT branch is created by developer before the pull request can be done.

There is also branch in Applify application. Think this as deployment from certain GIT branch. `EnableAutoBranchCreation` creates this Amplify app branch automatically when new GIT branches are created.
I think pull request previews is what you are looking for?

https://docs.aws.amazon.com/amplify/latest/userguide/pr-previews.html

Why do the Amplify docs say it creates new branches for every PR?

Relevant content