Adding an app

A new production app is not live on the hub until all of these exist. Hosts must be real *.riddlewallet.com URLs.

Checklist

1. Wallet lib/ecosystem.ts — add the production URL to ECOSYSTEM (env override + default host).
2. HUB_LINKS — append a card (title, description, href, key) so Wallet home / onboarding can launch it.
3. Hub catalog APPS + URLS — in this repo src/lib/catalog.ts (hub SSOT). slug, name, href from URLS, group, bullets, shots. Do not invent hosts. This docs portal reads URLS / APPS from that file.
4. Pills — if it belongs in the compact header switcher (~10 max), add it to SUITE_APP_PILLS in src/lib/suite-shell-config.ts (and the shared suite-chrome copy). Bottom nav stays the five primary destinations unless product asks otherwise.
5. Screenshots — capture live production only:

npm run capture
# node scripts/capture-live-apps.mjs

Writes public/media/apps/{id}-desktop.png and {id}-mobile.png. Point catalog shots() at those files. No generated art.

6. SSO — connect with https://wallet.riddlewallet.com?return=&app={id}&action=connect. Register app id on the Wallet allow-list. No second seed import. Cookie rdl_sess Domain=.riddlewallet.com.
7. Ads / brand / payloads — optional slot ids on GET https://dev.riddlewallet.com/api/ads/active?slot=. Solid chrome (brand). Native units (payloads). Keep /{slug} redirect to the live host.

After merge

• Hub /apps/{slug} and sitemap /apps/* pick up the catalog row automatically.
• Run capture again whenever the live UI changes.