TribeNest Help Center
Settings

Fan App (PWA) Configuration

Customize the icon, name, and screenshots fans see when they install your TribeNest fan app to their phone.

Your TribeNest fan site is also a Progressive Web App — usually called a PWA. That's a fancy way of saying fans can tap an "install" button in their browser and your site lives on their home screen like a real app, complete with your icon, your name, and a full-screen experience.

The PWA tab is where you set what that installed app looks and feels like. Every team member sees this tab — you don't need to be an owner.

What fans see

When a fan opens your TribeNest site on their phone, the browser will offer them an option like "Add to Home Screen" or "Install app". If they accept, your site installs as an icon on their device. Tapping that icon launches your TribeNest fan app full-screen, no browser bar in sight — a much better experience than re-typing your URL every time.

Some app stores and browsers also show screenshots of your app before fans install, to give them a preview of what they're getting.

The PWA tab is where you upload all of those assets and set the name and description that show up next to them.

How to configure your fan app

  1. Open Settings from the sidebar.
  2. Click the PWA tab.
  3. Fill in the App name, Short name, and Description.
  4. Upload each of the three App icons.
  5. Upload both App screenshots.
  6. Click Save.

Save kicks off uploads for any new files, then writes the configuration. You'll see a toast when everything is in.

Names and description

App name

The full name of your fan app. Up to 50 characters. This shows up in app stores, install prompts, and the app's window title bar. Use your full artist or band name here — "JUNO Music Official" is fine.

Short name

A condensed version that fits under your icon on a phone home screen. Up to 12 characters. Phones truncate longer names with an ellipsis, so keep it tight — "JUNO" beats "JUNO Music Official" on a small icon.

Description

A short pitch for your app, up to 200 characters. Some browsers and app stores show this on the install prompt. Keep it benefit-led — "Stream live shows, shop merch, and get exclusive drops from JUNO" works better than "Official JUNO app".

All three fields are required.

App icons

You'll upload three icon sizes. Each one needs to be exactly the dimensions listed — TribeNest validates the image before accepting it, and rejects anything that doesn't match.

FieldRequired sizeUsed for
Icon (192 × 192)192 × 192 pixelsStandard phone home screen
Icon (512 × 512)512 × 512 pixelsHigh-resolution displays and splash screens
Icon (96 × 96)96 × 96 pixelsSmaller contexts and notifications

All icons must be JPG, JPEG, or PNG. Square aspect ratio.

One source, three exports

Design your icon once at 1024 × 1024 in your favorite tool, then export it three times at the required sizes. Use a flat, bold design — fine details disappear at 96 pixels.

If you upload a file with the wrong dimensions, TribeNest shows an error toast and refuses the upload. Resize and try again.

App screenshots

Two screenshot slots, each with strict required dimensions:

FieldRequired sizeUsed for
Wide screenshot1280 × 720 pixelsTablet and desktop install previews
Narrow screenshot750 × 1334 pixelsPhone install previews

Both screenshots accept JPG, JPEG, or PNG.

Use real screenshots of your fan site — your homepage hero, your store, your membership page, anywhere visually rich. Avoid mockups with placeholder text; this is the first impression fans get before they hit install.

Previewing your icons

Once a file is selected — even before you click Save — TribeNest shows a small preview of the image right under the upload field. That makes it easy to spot a wrong file or a low-quality export before you commit.

When changes go live

After you click Save, the new configuration is stored against your TribeNest profile. Fans will see the new icons, name, and screenshots next time they visit your fan site and trigger an install prompt.

Fans who already installed your app won't automatically get the new icon — phone home screens only refresh icons in specific cases. To see the new look, they'd need to uninstall and reinstall. This is rarely worth asking them to do; just plan to update icons sparingly.

Icons are sticky

Once a fan installs your app, their phone caches your icon aggressively. Treat each icon update as roughly permanent — it's not worth iterating on weekly.

What you can't change here

A few PWA properties aren't exposed on this tab — TribeNest sets them sensibly on your behalf:

  • Theme color of the install prompt and status bar — pulled from your fan site's brand colors
  • Splash screen — generated from your 512 × 512 icon
  • Orientation lock — kept flexible so fans can rotate their phone

If you want to change the brand colors that drive theme color and the look of your fan site, head to my website.

Where to go next

  • Style your fan site with brand colors and content → my website
  • Send fans to install your app via email → emails
  • Connect a payout account so installs convert into orders → payment setup