Platform Architecture

Streamly is one Next.js application with host-aware routing. The same deploy serves the operator console, viewer storefront, marketing/legal pages, and /api/v1 tenant APIs.

High-Level Layout

Browser
  ├─ Platform host (e.g. streamly.watch)
  │    ├─ /admin/*          Operator console
  │    ├─ /dashboard/*      Tenant-owner console
  │    ├─ /site/*           Platform marketing (pretty URLs rewrite here)
  │    └─ storefront        Default / brand tenant
  └─ Tenant host ({slug}.streamly.watch)
       └─ Viewer routes     Catalog, watch, account, profiles

Supabase
  ├─ Auth (viewer + operator cookie scopes)
  └─ Postgres + RLS (control plane, catalog, billing, plugins)

Surfaces

Operator (`/admin`)

Overview, Users, Subscriptions, Plans, Catalog, Addons, Brand & Experience, Themes, Posts, Plugins, Settings (lib/operator/nav.ts).

Viewer storefront

Home, browse, movies/shows, title, watch, live, history, pricing, account, profiles — skins via theme packages.

Marketing & legal

Platform pretty URLs rewrite to /site/*. Legal markdown is bundled at build time for Cloudflare Workers.

APIs

Prefix	Role
`/api/v1/*`	Tenant-scoped product API
`/api/operator/*`	Operator branding, themes, plans, bank-transfer approve, …
`/api/admin/*`	Activation, onboarding, health
`/api/webhooks/stripe`	Stripe
`/api/webhooks/paypal`	PayPal
`/api/internal/jobs/run`	Cron (`STREAMLY_CRON_SECRET`)
`/api/docs`	OpenAPI

Tenant Resolution

Host pattern	Resolution
Platform host / localhost / `*.workers.dev`	Brand / default tenant
`{slug}.streamly.watch`	Tenant by slug
API header `x-streamly-tenant-id`	Explicit tenant for clients

Customer-owned custom domains are not supported (no Cloudflare for SaaS provisioning).

Themes & Branding

Packages under themes/<id>/; one route tree; theme_presets; preview /?__theme_preview=. See Themes & Skins.

Deploy Targets

Target	Path
Node 20+	`pnpm run build` + `pnpm run start`
Docker / OCI	Included `Dockerfile`
Cloudflare Workers	`pnpm run deploy:cloudflare`

​High-Level Layout

​Surfaces

​Operator (/admin)

​Viewer storefront

​Marketing & legal

​APIs

​Tenant Resolution

​Themes & Branding

​Deploy Targets

​Related

High-Level Layout

Surfaces

Operator (`/admin`)

Viewer storefront

Marketing & legal

APIs

Tenant Resolution

Themes & Branding

Deploy Targets

Related