Domain Topology

Domain Overview

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

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

The operations app (ops.zooly.ai) can connect to either backend:

• Use app.zooly.ai for read/write operations
• Use api-readonly.zooly.ai for read-only operations

This architecture allows deploying quick fixes to the operations app for viewing statistics without deploying the full application, reducing deployment risk.

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