> 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/navigation-bar.md).

# Navigation Bar

Style the top bar that carries your screen title or logo and its action buttons.

The navigation bar runs along the top of your app. It carries the screen title — or your logo — and any action buttons you add, such as search or cart.

## Screen title or logo

<figure><img src="https://3731994945-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MlBy5z08zL1UoCwNqmg%2Fuploads%2Fgit-blob-edddc53ca236e75454acfbb591c00b7695f72dd7%2Fnavigation-bar-title.png?alt=media" alt="The Navigation Bar editor showing text style, colour and title image settings"><figcaption></figcaption></figure>

<table><thead><tr><th width="200">Setting</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Text style</strong></td><td>Pick a preset from your Text theme, or choose <strong>Custom</strong> to set size, weight and font here.</td></tr><tr><td><strong>Color</strong></td><td>A theme colour or a custom hex value.</td></tr><tr><td><strong>Title image</strong></td><td>Height and width, used when your title is a logo rather than text.</td></tr></tbody></table>

Using a preset from your Text theme keeps the bar consistent with the rest of the app, and means a later change to that preset carries through here too.

**Font style** is a premium feature. The presets come from your [Text Theme](https://help.twinr.dev/app-theme/app-theme/text-theme.md).

## Background

**Background color** sets the bar's fill — a theme colour or a custom hex value with opacity.

{% hint style="info" %}
**This colour reaches the status bar too.** Unless you disable the navigation bar, the strip with the clock and battery takes its background from here.
{% endhint %}

## Action buttons

<figure><img src="https://3731994945-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MlBy5z08zL1UoCwNqmg%2Fuploads%2Fgit-blob-c247e8024dd6452253df4c9d1aee8eea81f3b760%2Fnavigation-bar-buttons.png?alt=media" alt="The Buttons group with button size, button spacing and leading and trailing edge spacing"><figcaption></figcaption></figure>

<table><thead><tr><th width="200">Setting</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Button size</strong></td><td>Height and width of each button, in pixels.</td></tr><tr><td><strong>Button spacing</strong></td><td>The gap between buttons.</td></tr><tr><td><strong>Edge spacing</strong></td><td><strong>Leading</strong> is the gap before the first button on the left; <strong>Trailing</strong> is the gap after the last one on the right.</td></tr></tbody></table>

{% hint style="warning" %}
**Keep buttons large enough to tap.** Both Apple and Google recommend a touch target of at least 44 points — a button sized to look elegant can be one people keep missing.
{% endhint %}

The buttons themselves are added per screen, not here — see [Navigation Bar Buttons](https://help.twinr.dev/navigation-bar-buttons/navigation-bar-buttons.md). This page only sets how they look.

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