Advanced Topics

DartStream is a microservice-based SaaS product. Advanced implementation work often spans frontend routing, Firebase Hosting, service-specific APIs, Kubernetes deployments, Stripe billing, Secret Manager, and GitOps reconciliation.

Microservice Architecture

The DartStream app is separate from its backend services. Production service hostnames include:

  • apiauth.dartstream.io

  • apibilling.dartstream.io

  • apiplatform.dartstream.io

  • apipersistence.dartstream.io

  • apireactivedataflow.dartstream.io

Development service hostnames use the dev- prefix, such as dev-apibilling.dartstream.io.

Runtime Service Routing

The frontend routes requests by endpoint family:

  • /auth/ and /api/v1/auth/ go to auth.

  • /api/billing/, /api/v1/billing/, and /api/v1/tenants/* go to billing.

  • /api/enterprise/ and /api/v1/enterprise/ go to platform services.

  • persistence and reactive endpoints go to their dedicated services.

Stripe Lifecycle

Stripe Checkout and Billing Portal are live handoff points. A billing workflow is not complete until:

  • Checkout or Portal opens successfully.

  • Stripe webhook delivery is verified.

  • DartStream billing state updates.

  • The app UI refreshes to the correct plan and status.

  • Logout and login preserve the expected entitlement state.

Feature Provider Boundaries

Use IntelliToggle for dedicated feature flag evaluation. Use DartStream for the broader operational context: membership, entitlements, live config, telemetry, game services, provider orchestration, and dashboard workflows.

Production Readiness

For any new capability, verify:

  • dev and prod environment values

  • frontend routing

  • backend service health

  • CORS

  • entitlement checks

  • browser QA

  • logs and audit behavior

  • docs and API reference updates