Skip to content

Layout & navigation

The Tauri window has three rows of chrome:

  1. Title bar — drag region with the Splintertree wordmark, a Settings cog that opens local launcher settings, and the Win/Mac-style minimize / max / close buttons.
  2. Toolbar — Home, Shop (when enabled), Social, Database (dropdown), Addons, plus a token balance pill, a <7d gametime warning chip, and the account menu.
  3. Content area — the active route, framed by the home-page game rail and footer Play bar.

Title bar

  • The Splintertree wordmark is fixed left, the window controls are fixed right; everything between is a drag region for moving the window.
  • The Settings cog appears once the user is signed in. It opens LauncherSettingsPage (local-only client settings: WoW path, API base URL, patch locale) — account, security and 2FA live in the Account menu instead.

Toolbar

  • Home (/launcher) — the index page with news, realms, changelog and the vertical game rail. The footer Play bar only renders here.
  • Shop (/launcher/shop) — the in-launcher storefront, only visible when site.shop_enabled is on.
  • Social (/launcher/friends) — friends list, account-level DMs, guild channels (G + Officer). See Social & guild chat.
  • Database — dropdown linking to the public game database (/launcher/db/items, /quests, /npcs, /achievements, /guilds, /zones, /characters). All routes re-mount the public Vue components under LauncherLayout so the chrome stays consistent.
  • Addons (/launcher/addons) — per-game client addon catalogue with install / update / remove. See Addons.
  • Token balance pill — opens the shop on click.
  • Gametime warning chip — appears with siteInfo.gametime_enabled when the player has fewer than 7 days of subscription left. Click jumps straight to the redeem-code dialog.
  • Account menu — splintertag avatar; menu has Manage account, Redeem code, Logout.

Game rail (home page only)

The vertical rail on the left of the home page lists every published game. Each entry uses the bundled silhouette SVG tinted with the game's icon_colors (primary / secondary / accent) so games are distinguishable without needing per-game art. The tooltip shows the game name plus its operator-set tagline.

Switching games immediately re-runs the My Realms + News fetches scoped to the new game's slug.

Footer Play bar (home page only)

The footer renders only on the index route. It shows the active game's icon + name + tagline (capped at 30vw), the install / patch progress bar, and the Play button. Play kicks off:

  1. Fetch /api/v1/launcher/auth-server and write realmlist.wtf into the WoW directory root, Data/, and every Data/<locale>/ so a third-party install that ships a non-default value can't override us.
  2. Resolve Wow.exe (case-tolerant) and spawn it via Wine.

The window stays responsive — the spawn is fire-and-forget; the launcher doesn't wait on the child process.