# saas-starter-kit/saas-starter-kit-pro architecture

> Architecture diagram of the GitHub repository saas-starter-kit/saas-starter-kit-pro, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/saas-starter-kit/saas-starter-kit-pro
- Repository: https://github.com/saas-starter-kit/saas-starter-kit-pro

## Overview

##### Project type and purpose
- This is a full-stack SaaS template comprising:
- A React/Next.js client (“client” folder)
- A Node.js/Express API server (“server” folder)
- AWS infrastructure defined via CDK for CI/CD, an ECS Fargate service, and serverless Lambdas (“infrastructure” folder)
- Machine-learning experiments kept separately (“machine learning” folder)
- The client delivers marketing, auth, purchase and application UIs. The server exposes REST endpoints, handles business logic, data persistence (Mongo and SQL), email notifications, Stripe operations, permissions, and integrates Firebase/Sentry.

##### File structure
- Top-level separation: client | server | infrastructure | machine learning
- Frontend follows Next.js conventions: pages, components, screens, services, store (Redux), hooks, styles
- Backend is Express-based: routing under src/API, business logic in src/Services, data models in src/Model (mongo and sql), middleware, and configuration modules (stripe, email, firebase, permissions)
- Infrastructure uses AWS CDK to define three distinct stacks:
- AWS CICD Pipeline (build and deploy)
- AWS Fargate API Server (ECS, RDS, VPC, IAM roles, secrets)
- AWS Lambda serverless CRUD functions
- Configuration files present for Docker, Babel, environment variables, Prettier, Jest, CDK, etc.

##### README
- The readme simply points to a new maintained SaaS template. However, folder names and configs reveal the intended architecture: a scal­able, containerized API behind CI/CD, plus an optional serverless layer and ML experiments.

##### Essential details
- Runtime dependencies (databases, caches if any, external APIs)
- Environment/secret management (AWS Secrets Manager or Parameter Store)
- Don’t forget monitoring/tracing: Sentry and any CloudWatch metrics
- Machine-learning folder separately as an offline or research component not in the production data flow

## Diagram (Mermaid)

```mermaid
graph TD
    %% CI/CD Pipeline
    subgraph "CI/CD Pipeline" 
        CI["CodePipeline / CodeBuild / CodeDeploy"]:::infra
    end

    %% Frontend Layer
    subgraph "Frontend Layer"
        CLIENT["Next.js Client"]:::frontend
        PAGES["Pages (SSR Routes)"]:::frontend
        COMPS["Components (Auth, Marketing, Purchase, User UIs)"]:::frontend
        STORE["Redux Store (Actions/Reducers)"]:::frontend
        SERVICES_C["Client Services (Axios, Stripe, Firebase, CASL)"]:::frontend
        HOOKS["Client Hooks"]:::frontend
        CLIENT --> PAGES
        CLIENT --> COMPS
        CLIENT --> STORE
        CLIENT --> SERVICES_C
        CLIENT --> HOOKS
    end

    %% API Layer
    subgraph "API Layer"
        ENTRY["server.js"]:::backend
        APP["app.js"]:::backend
        ROUTES["API Routing (auth, org, users, roles, todos, webhooks)"]:::backend
        SERVICES_B["Business Logic Services"]:::backend
        MODELS["Data Models (Mongo & SQL schemas)"]:::backend
        DB_MONGO["MongoDB Setup"]:::backend
        DB_SQL["SQL DB Setup"]:::backend
        MIDDLEWARE["Middleware (error, auth, rate-limit, permissions)"]:::backend
        CONFIG_STRIPE["Stripe SDK Config"]:::backend
        CONFIG_SB["Sendinblue Config"]:::backend
        EMAILS["Email Templates & Subjects"]:::backend
        CONFIG_FIRE["Firebase Auth Config"]:::backend
        CONFIG_SENTRY["Sentry Config"]:::backend
        CONFIG_PERM["Permissions Rules"]:::backend

        ENTRY --> APP
        APP --> ROUTES
        APP --> SERVICES_B
        APP --> MODELS
        APP --> MIDDLEWARE
        SERVICES_B --> CONFIG_STRIPE
        SERVICES_B --> CONFIG_SB
        SERVICES_B --> EMAILS
        SERVICES_B --> CONFIG_FIRE
        SERVICES_B --> CONFIG_SENTRY
        SERVICES_B --> CONFIG_PERM
        MODELS --> DB_MONGO
        MODELS --> DB_SQL
    end

    %% Serverless Layer
    subgraph "Serverless Layer"
        APIGW["API Gateway"]:::infra
        LAMBDAS["Lambda CRUD Functions"]:::infra
        APIGW --> LAMBDAS
    end

    %% Data Layer
    subgraph "Data Layer"
        MDB["MongoDB (Atlas)"]:::data
        SQLDB["RDS / Postgres"]:::data
    end

    %% External Services
    subgraph "External Services"
        STRIPE["Stripe API"]:::external
        FIREBASE["Firebase Auth"]:::external
        SENDIN["Sendinblue Email"]:::external
        SENTRY_EXT["Sentry"]:::external
    end

    %% Machine Learning (Offline)
    ML["Machine-learning Experiments"]:::ml

    %% Load Balancer
    LB["ALB / API Gateway"]:::infra

    %% Interactions
    Browser["User Browser"]:::frontend
    Browser -->|"HTTPS Request"| LB
    LB -->|"Routes to Fargate"| ENTRY
    LB -->|"Routes to Serverless"| APIGW
    ENTRY -->|"Read/Write"| MDB
    ENTRY -->|"Read/Write"| SQLDB
    ENTRY -->|"Webhook/SDK Calls"| STRIPE
    ENTRY -->|"Token Validation"| FIREBASE
    ENTRY -->|"Send Emails"| SENDIN
    ENTRY -->|"Error Reporting"| SENTRY_EXT

    %% CI/CD Deployments
    CI -->|"Deploy Client"| CLIENT
    CI -->|"Deploy Fargate Service"| ENTRY
    CI -->|"Deploy Lambda Layer"| LAMBDAS

    %% Click Events
    click CLIENT "https://github.com/saas-starter-kit/saas-starter-kit-pro/tree/main/client/"
    click PAGES "https://github.com/saas-starter-kit/saas-starter-kit-pro/tree/main/client/src/pages/"
    click COMPS "https://github.com/saas-starter-kit/saas-starter-kit-pro/tree/main/client/src/components/"
    click STORE "https://github.com/saas-starter-kit/saas-starter-kit-pro/tree/main/client/src/store/"
    click SERVICES_C "https://github.com/saas-starter-kit/saas-starter-kit-pro/tree/main/client/src/services/"
    click HOOKS "https://github.com/saas-starter-kit/saas-starter-kit-pro/tree/main/client/src/hooks/"
    click ENTRY "https://github.com/saas-starter-kit/saas-starter-kit-pro/blob/main/server/server.js"
    click APP "https://github.com/saas-starter-kit/saas-starter-kit-pro/blob/main/server/src/app.js"
    click ROUTES "https://github.com/saas-starter-kit/saas-starter-kit-pro/tree/main/server/src/API/"
    click SERVICES_B "https://github.com/saas-starter-kit/saas-starter-kit-pro/tree/main/server/src/Services/"
    click MODELS "https://github.com/saas-starter-kit/saas-starter-kit-pro/tree/main/server/src/Model/"
    click DB_MONGO "https://github.com/saas-starter-kit/saas-starter-kit-pro/blob/main/server/src/Database/mongo/db.js"
    click DB_SQL "https://github.com/saas-starter-kit/saas-starter-kit-pro/blob/main/server/src/Database/sql/db.js"
    click MIDDLEWARE "https://github.com/saas-starter-kit/saas-starter-kit-pro/tree/main/server/src/Middleware/"
    click CONFIG_STRIPE "https://github.com/saas-starter-kit/saas-starter-kit-pro/blob/main/server/src/Config/stripe.js"
    click CONFIG_SB "https://github.com/saas-starter-kit/saas-starter-kit-pro/blob/main/server/src/Config/sendinblue.js"
    click EMAILS "https://github.com/saas-starter-kit/saas-starter-kit-pro/tree/main/server/src/emails/"
    click CONFIG_FIRE "https://github.com/saas-starter-kit/saas-starter-kit-pro/blob/main/server/src/Config/firebase.js"
    click CONFIG_SENTRY "https://github.com/saas-starter-kit/saas-starter-kit-pro/blob/main/server/src/Config/sentry.js"
    click CONFIG_PERM "https://github.com/saas-starter-kit/saas-starter-kit-pro/blob/main/server/src/Config/permissions.js"
    click CI "https://github.com/saas-starter-kit/saas-starter-kit-pro/tree/main/infrastructure/AWS CICD Pipeline/"
    click LAMBDAS "https://github.com/saas-starter-kit/saas-starter-kit-pro/tree/main/infrastructure/AWS Lambda/"
    click ML "https://github.com/saas-starter-kit/saas-starter-kit-pro/tree/main/machine learning/"

    %% Styles
    classDef frontend fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef backend fill:#90EE90,stroke:#333,stroke-width:1px
    classDef data fill:#FFD580,stroke:#333,stroke-width:1px
    classDef external fill:#D8BFD8,stroke:#333,stroke-width:1px
    classDef infra fill:#D3D3D3,stroke:#333,stroke-width:1px
    classDef ml fill:#E0E0E0,stroke:#333,stroke-width:1px
```
