> For the complete documentation index, see [llms.txt](https://help.twinr.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.twinr.dev/app-theme/bottom-tab-bar.md).

# Bottom Tab Bar

Style the tab bar pinned to the bottom of every screen.

The tab bar sits at the bottom of every screen and holds your app's main destinations. It is the navigation customers use most, so it is worth getting right.

<figure><img src="https://3731994945-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MlBy5z08zL1UoCwNqmg%2Fuploads%2Fgit-blob-0d8630c299aa5b22ff801d3c798fc3e8361cc6d0%2Ftab-bar-preview.png?alt=media" alt="The Bottom Tab Bar editor with a live preview of the bar above the settings"><figcaption></figcaption></figure>

The preview at the top shows your bar as it will appear, and stays in view as you scroll through the settings.

## Style and labels

**Select style** changes the shape and behaviour of the whole bar.

<figure><img src="https://3731994945-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MlBy5z08zL1UoCwNqmg%2Fuploads%2Fgit-blob-10ac445f74a6a630c73d9c7d6aba99101902bd39%2Ftab-bar-styles.png?alt=media" alt="The Select style dropdown showing Default plus four premium styles"><figcaption></figcaption></figure>

| Style                    |                                                             |
| ------------------------ | ----------------------------------------------------------- |
| **Default**              | A plain bar with icons and labels. Available on every plan. |
| **Material Design Bar**  | Premium                                                     |
| **Animated Pill Bar**    | Premium                                                     |
| **Flashy Icon Bar**      | Premium                                                     |
| **Persistent Slide Bar** | Premium                                                     |

**Enable title text** shows a label under each icon. Turning it off leaves icons alone — cleaner, but only safe when your icons are unmistakable.

## Colours

<figure><img src="https://3731994945-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MlBy5z08zL1UoCwNqmg%2Fuploads%2Fgit-blob-94ba5a48b0e5c842450f28c1d6670d9669f7cd35%2Ftab-bar-colors.png?alt=media" alt="The Other tabs and Bar groups with unselected text colour, font style, background colour and tab icon size"><figcaption></figcaption></figure>

<table><thead><tr><th width="230">Setting</th><th>What it changes</th></tr></thead><tbody><tr><td><strong>Selected text color</strong></td><td>The tab the customer is currently on.</td></tr><tr><td><strong>Unselected text color</strong></td><td>Every other tab.</td></tr><tr><td><strong>Background color</strong></td><td>The bar itself.</td></tr><tr><td><strong>Tab icon size</strong></td><td>Icon height and width in pixels. The default is 20 × 20.</td></tr></tbody></table>

Each colour can be a theme colour or a custom hex value with opacity.

{% hint style="info" %}
**Make selected and unselected clearly different.** This contrast is the only thing telling customers where they are in your app. A light grey against a slightly darker grey reads as broken rather than subtle.
{% endhint %}

**Font style** on either state is a premium feature.

Click **Save as draft** to keep your changes.
