Worldshaper/docs/kb/systems/launcher-home.md

Launcher Home

What It Does

The launcher is the public-facing entry point for Worldshaper. It presents the hero card, opens the editor in its own floating window, links to the repo, and hosts the News and Requests tabs.

Key Files

• src/WorldshaperLauncher.tsx
• src/index.css
• src/worldshaperStudio/windowing.ts

Endpoints It Uses

• GET /api/world-default
• GET /api/launcher-requests

Important State

• launch state: ready, opening, opened, blocked, error
• active board tab: news or requests
• request list, filters, and expanded request rows
• resolved default world id

Invariants And Constraints

• The editor is intended to open in a separate popup-style window.
• The launcher should still work if the default world lookup fails by falling back to overworld.
• Browser popup blocking is a real failure mode and must be surfaced to the user.

Common Request Themes

• page styling and presentation
• launch flow and popup behavior
• repo button or external links
• tab layout and launcher information architecture

Triage Questions

• Is this about the launcher page itself, or the studio window after launch?
• Does it affect only presentation, or also request API behavior?
• Does it depend on popup/window behavior?