# learntocloud/learn-to-cloud architecture

> Architecture diagram of the GitHub repository learntocloud/learn-to-cloud, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/learntocloud/learn-to-cloud
- Repository: https://github.com/learntocloud/learn-to-cloud

## Overview

##### Main Components

a) Frontend Layer:
- Docusaurus Static Site Generator
- React Components (in /src/components)
- Internationalization System (i18n)
- Static Assets (images, CSS)

b) Build & Deployment Layer:
- Docker Container System
- Azure Static Web Apps
- GitHub Actions CI/CD

c) Content Management Layer:
- Markdown Documentation
- Multi-language Support
- Version Control (Git)

**[User Browser] → [Azure Static Web Apps] → [Content Delivery]**
- ↑                    ↑                      ↑

**[Frontend Layer] ← [Build System] ← [Content Management]**

##### Component Relationships

- Content flow from Markdown files through the build process to static assets
- CI/CD pipeline flow from GitHub through Azure deployment
- User request flow through Azure Static Web Apps to content delivery
- Docker container build and serve processes

##### Specific Implementation Details

Key technical elements:
- Docusaurus configuration and routing
- Multi-language support system
- Docker multi-stage build process
- GitHub Actions workflows
- Azure Static Web Apps hosting

##### Implementation Notes

Use standardized symbols for:
- Cloud services (Azure)
- Container services (Docker)
- Static file hosting
- CI/CD pipelines
- Content management systems

##### The content management workflow

This system design should help developers understand both the high-level architecture and the specific implementation details of the Learn to Cloud guide website.

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Browser
        User[User Browser]
    end

    subgraph "Azure Infrastructure"
        ASWA[Azure Static Web Apps]:::azure
        CDN[Content Delivery Network]:::azure
    end

    subgraph "Frontend Layer"
        DSG[Docusaurus Static Generator]:::frontend
        RC[React Components]:::frontend
        Pages[Frontend Pages]:::frontend
        SA[Static Assets]:::frontend
        CSS[CSS Styling]:::frontend
        Nav[Site Navigation]:::frontend
    end

    subgraph "Build System"
        Docker[Docker Container]:::build
        DevContainer[Development Container]:::build
        GHA[GitHub Actions CI/CD]:::build
    end

    subgraph "Content Management"
        MD[Markdown Documentation]:::content
        I18N[Internationalization]:::content
        Config[Docusaurus Config]:::content
    end

    %% Relationships
    User --> ASWA
    ASWA --> CDN
    CDN --> User

    Config --> DSG
    MD --> DSG
    I18N --> DSG
    RC --> DSG
    Pages --> DSG
    SA --> DSG
    CSS --> DSG
    Nav --> DSG

    DSG --> Docker
    Docker --> GHA
    DevContainer --> Docker
    GHA --> ASWA

    %% Click Events
    click RC "https://github.com/learntocloud/learn-to-cloud/tree/main/src/components/"
    click SA "https://github.com/learntocloud/learn-to-cloud/tree/main/static/"
    click CSS "https://github.com/learntocloud/learn-to-cloud/blob/main/src/css/custom.css"
    click MD "https://github.com/learntocloud/learn-to-cloud/tree/main/docs/"
    click I18N "https://github.com/learntocloud/learn-to-cloud/tree/main/i18n/"
    click Docker "https://github.com/learntocloud/learn-to-cloud/tree/main/Dockerfile"
    click GHA "https://github.com/learntocloud/learn-to-cloud/tree/main/.github/workflows/"
    click Config "https://github.com/learntocloud/learn-to-cloud/blob/main/docusaurus.config.js"
    click Pages "https://github.com/learntocloud/learn-to-cloud/tree/main/src/pages/"
    click DevContainer "https://github.com/learntocloud/learn-to-cloud/blob/main/.devcontainer/devcontainer.json"
    click Nav "https://github.com/learntocloud/learn-to-cloud/blob/main/sidebars.js"

    %% Styling
    classDef frontend fill:#3498db,stroke:#2980b9,color:white
    classDef build fill:#2ecc71,stroke:#27ae60,color:white
    classDef content fill:#e67e22,stroke:#d35400,color:white
    classDef azure fill:#95a5a6,stroke:#7f8c8d,color:white

    %% Legend
    subgraph Legend
        F[Frontend]:::frontend
        B[Build System]:::build
        C[Content]:::content
        A[Azure]:::azure
    end
```
