Domain Topology

PreviousNext

Domain structure and organization for Zooly applications

Domain Topology

Domain Overview

All Zooly applications use subdomains under the zooly.ai apex domain. The following domains are used across environments:

DomainPurposeLocal Port
auth.zooly.aiSingle entrypoint for authentication across all Zooly applications3003
app.zooly.aiMain application for authenticated users and Experiences (mini-apps)3004
docs.zooly.aiDocumentation application3006

Central Authentication

  • auth.zooly.ai - Single entrypoint for all authentication across all Zooly applications (localhost:3003)

Application Domains

Core Applications

  • zooly.ai - Public-facing content application for landing pages, marketing materials, and other non-authenticated content
  • app.zooly.ai - Full-featured application for authenticated users and Experiences (mini-apps)

Backend Services

  • app.zooly.ai - Shared backend API for all applications, handling read/write operations
  • api-readonly.zooly.ai - Read-only API service for statistics and metrics

Reverse Proxy Applications

Several applications use reverse proxy routing to provide dedicated domains while maintaining a single deployment:

  • merch.zooly.ai - Routes to app.zooly.ai/merch-app
  • photobomb.zooly.ai - Routes to app.zooly.ai/photobomb-app
  • backstage.zooly.ai - Routes to app.zooly.ai/backstage-app

Benefits of this approach:

  • Single deployment - All client-facing apps share one deployment, ensuring compatibility and consistency
  • Safe deployments - Changes are tested and deployed together, reducing integration issues
  • Simplified development - Test apps via paths like dev.zooly.ai/merch-app without requiring separate domain deployments

Authentication

All applications under *.zooly.ai share the same authentication session, providing seamless user experience across domains.

Test environments

  • stage.zooly.ai - Staging environment
  • dev.zooly.ai - Development environment