Repo Branch Picker

ProNew

A branch picker with default and protected markers that offers to create a branch from the text you typed, with git-name validation. Use this when people switch or create branches.

Customize

Derived from this item’s props table, because it declares no controls of its own. This item has no standalone playground, so changes update the code, the share link and the AI prompt.

value

defaultValue

disabled

Guide and examples

When to use it

Use it in developer tools, deployment settings and code hosts, where the same field is used to find an existing branch or to make a new one from what was typed.

Do not use it when branches are created elsewhere. Then a plain searchable select is enough.

Installation

This item is part of tealmac UI Pro

The source for this item installs with a Pro licence key. Log in with your key to see the install command, or read the Pro setup page.

Props

Prop	Type	Default	Description
`branches`	`{ name, default?, protected? }[]`	-	Existing branches.
`value`	`string`	-	Current branch name (controlled).
`defaultValue`	`string`	-	Initial branch.
`onValueChange`	`(name: string) => void`	-	Runs when a branch is picked.
`onCreate`	`(name: string, from: string) => void`	-	Runs when a new branch is created from the default branch.
`disabled`	`boolean`	`false`	Disables the button.

Accessibility

The button is a combobox; its name is Branch: <name>.
The Create row is an option that stays visible while the text matches no branch (it is forceMounted so the filter cannot hide it).
Names that git would reject (spaces become dashes; .., a leading dash, a trailing .lock or /, @{) show the reason in a role="status" line instead.
Default and protected are written out as badges, not shown by icon or colour alone.

Testing

The pattern ships with a Testing Library test (repo-branch-picker.test.tsx) that covers markers, the Create row, name normalisation and invalid names.