App

The Subscriberbot app shell is a cross-platform application built on the Burdenoff microfrontend architecture. It composes the Subscriberbot microfrontend (@burdenoff/microfe-subscriberbot) with shared platform microfrontends (auth, billing, workspaces, tags, files, etc.) into a single cohesive experience.

Platforms

Platform	How to run	Default URL
Web	bun run dev (port 5237) or visit app.subscriberbot.com	https://app.subscriberbot.com
Desktop (Electron)	bun run electron:dev or bun run electron:run:prod	Packaged app
Android	bun run android:run	APK via Capacitor
iOS	bun run ios:run	Xcode via Capacitor

Architecture

The app follows the 4-layer microfrontend architecture:

• Layer 0: Shared foundation from @burdenoff/fe-libs/shared
• Layer 1: Primitive components from @burdenoff/fe-libs
• Layer 2: Feature microfrontends from @burdenoff/micro-fe
• Layer 3: This host shell (composition and orchestration)

Development

git clone https://github.com/algoshred/subscriberbot-app.git
cd subscriberbot-app
bun install
bun run dev          # Web dev server on port 5237
bun run build        # Production build
bun run sanity       # Lint + format + type-check + test + build

Cross-platform builds

# Android
bun run android:build
bun run android:run

# iOS
bun run ios:build
bun run ios:run

# Electron
bun run electron:run:prod
bun run electron:pack:prod
bun run electron:release:prod

Configuration

Copy .env.example to .env.local and configure gateway base URLs:

Variable	Default (local)	Production
VITE_WSPACE_GATEWAY_URL	http://localhost:4003	https://graphqlworkspaces.burdenoff.com
VITE_GLOBAL_GATEWAY_URL	http://localhost:4000	https://graphql.burdenoff.com

Gateway URLs should be base URLs only (no path). The GraphQL client appends:

• /workspaces/graphql for the workspace gateway
• /global/graphql for the global gateway

Environment selection

The app shell targets production by default. To build for alpha or local, set BURDENOFF_ENV before building:

# Alpha
BURDENOFF_ENV=alpha bun run build

# Local (default)
BURDENOFF_ENV=local bun run build

See Environment Selection for endpoint details.

Related

• Repository: subscriberbot-app
• Backend: wspace-subscriberbot-svc