> For the complete documentation index, see [llms.txt](https://wiki.4thtech.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.4thtech.io/products/white-label/branding.md).

# Brand it

Change the title, links, navigation and look of the white-label app using app.config.ts and the theme.

{% hint style="info" %}
**Status: Production-ready, stable.** The 4thTech SDK and the BlockMail & BlockChat white-label apps are supported; no new features are planned. Last release: SDK 0.5.13 (25 Nov 2025).
{% endhint %}

Most branding lives in `app.config.ts` at the root of the project.

## Title, description and social

```ts
meta: {
  title: '<your-app-name>',
  titleSuffix: '<your tagline>',
  description: '<your description>',
  twitter: { site: '<your-x-handle>' },
},
```

The title shows in the browser tab, and the tagline is added on the start page.

## Legal links

```ts
links: {
  privacyPolicy: '<url-of-your-privacy-policy>',
  termsOfUse: '<url-of-your-terms-of-use>',
},
```

These two links appear in the connect dialog, next to the **I read and accepted** checkbox. Replace them with your own documents.

## Navigation and toolbar

Under `layout.collapse`, you can show or hide the toolbar and the navigation, set the toolbar tools (theme toggle, network button, account menu) and edit the navigation items (name, icon, route). The default items are Dashboard, Mail (Compose new, Inbox, Sent), Chat and Settings.

## Theme

* Colours: `tailwind.config.js` sets `primary` (blue by default) and `muted` (slate). Change them to match your brand.
* Fonts: Inter and Karla, set in `tailwind.config.js` and loaded in `nuxt.config.ts`.
* Component shapes: the `nui.defaultShapes` section of `app.config.ts` sets rounded, curved or straight shapes for buttons, cards, inputs and more.
* Logo and favicon: the logo is the `LogoIcon` component (an SVG) and the favicon is `public/img/favicon.png`.

The start page text is in `components/LandingHero.vue`.

{% hint style="info" %}
**Screenshot to capture:** `white-label--web--branding--before-after--light--1280.png`. The start page before and after changing the title, logo and theme colour.
{% endhint %}

Check your changes with `npm run dev`, then see [Build and deploy](https://wiki.4thtech.io/products/white-label/deploy.md).
