Waymaker
Waymaker Host

Listing Your App in the App Store

Learn about Listing Your App in the App Store in WaymakerOS.

App StoreDistribution

Make your app discoverable to other workspaces in your organisation. When listed, your app appears in the Browse Apps section of Commander, where any workspace can subscribe to it.

How Listing Works

Every app deployed through Host gets a URL. By default, only the workspace that created the app can access it. Listing makes the app visible to all workspaces in your organisation — they can browse it, subscribe, and open it in Commander tabs.

ListedBehaviour
Off (default)Only your workspace sees the app
OnAll workspaces in your organisation can discover and subscribe

Listing Your App

  1. Open Host and select your app
  2. Go to the App Store tab
  3. Toggle Listed on

Your app immediately appears in the Browse Apps section across all workspaces in your organisation.

Unlisting Your App

  1. Open Host and select your app
  2. Go to the App Store tab
  3. Toggle Listed off

The app no longer appears in Browse Apps. Existing subscribers keep their access — unlisting does not revoke subscriptions. If you need to remove all subscribers, use the revoke option.

Revoking All Subscriptions

If you need to remove every workspace's access to your app:

waymaker apps revoke-all <app-id>

This removes all active subscriptions immediately. Subscribers will no longer see the app in their workspace.

What Subscribers See

When a workspace subscribes to your app:

  • The app appears in their My Apps section in Commander
  • They can open it in a Commander tab (embedded) or pop it out to a full-screen window
  • They see the same deployed version you see — updates are instant
  • They do not get access to your app's source code, settings, or environment variables

Requirements for Listing

Your app must be:

  • Active — successfully deployed at least once
  • In the same organisation — listing is organisation-scoped, not public

CLI

# List your app
waymaker host apps update <app-id> --listed

# Unlist your app
waymaker host apps update <app-id> --unlisted

Next Steps