# klsoundarya/tales-from-south-india architecture

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

- Interactive diagram: https://gitdiagram.com/klsoundarya/tales-from-south-india
- Repository: https://github.com/klsoundarya/tales-from-south-india

## Overview

##### Main components
a. Developer Workstation
- IDE (VS Code / Gitpod)
- Local Git repo
- .devcontainer (Dockerfile + docker-compose) for local preview (http_server.py)
b. GitHub
- Remote code repository (push/pull)
- GitHub Pages (static site hosting)
c. CDN / Browser Client
- End-user browsers on various devices
- Fetches HTML, CSS, JS, images, video

##### Relationships and data flows
- Developer writes code locally → commits & pushes to GitHub
- GitHub Pages automatically serves built static files
- Browser issues HTTP(S) GET requests → receives static assets (HTML, CSS, images, video)
- Responsive design assets adapt rendering for mobile/tablet/desktop

##### Architectural patterns
- Static Site Architecture (no server-side logic)
- Responsive Design (CSS media-queries)
- DRY asset organization (single CSS file, centralized assets folder)
- Containerized Local Dev Environment (uses Docker to simulate HTTP server)

##### Relevant technologies
- HTML5, CSS3, media queries, favicon, webfont (Google Fonts, Font Awesome)
- Static deployment via GitHub Pages
- Devcontainer definitions (.devcontainer/Dockerfile, docker-compose.yml)
- Python HTTP server script (for local preview)

##### Essential details to capture
- Separation of Dev vs. Deployment vs. Runtime environments
- No backend server: all pages are static
- Responsive breakpoints (375px, 425px, 768px, 992px, 1200px)
- Assets live under a single folder, served via GitHub Pages

##### Final checklist
- Components: Developer IDE/Container, GitHub Repo, GitHub Pages, Client Browsers
- Data Flows: Commit → Push → Deploy → Request → Response

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Developer Workflow
    subgraph "Developer Workflow"
        IDE["IDE (VS Code/Gitpod)"]:::dev
        GitLocal["Local Git Repo"]:::dev
        DevCont[".devcontainer (Docker)"]:::dev
        HTTPServer[".devcontainer HTTP Server"]:::dev
        BuildAssets["Build Assets Scripts"]:::dev
    end

    %% Version Control & CI/CD
    subgraph "Version Control & CI/CD"
        GitRepo["GitHub Repo"]:::version
        GitIgnore[".gitignore"]:::version
        README["README.md"]:::version
    end

    %% Hosting & Delivery
    subgraph "Hosting & Delivery"
        GitPages["GitHub Pages CDN"]:::host
        CSS["styles.css"]:::host
        Images["Image Assets"]:::host
        Video["ThankYou-bg-video.mp4"]:::host
    end

    %% Client Side
    subgraph "Client Side"
        Browser["Browser Client"]:::client
    end

    %% Connections
    IDE --> GitLocal
    GitLocal -->|"git push"| GitRepo
    GitRepo -->|"deploy"| GitPages
    Browser -->|"HTTP GET /index.html"| GitPages
    GitPages -->|"200 OK + assets"| Browser

    DevCont --> HTTPServer
    DevCont --> BuildAssets
    Browser -->|"local preview GET"| HTTPServer

    %% Click Events
    click DevCont "https://github.com/klsoundarya/tales-from-south-india/tree/main/.devcontainer/"
    click HTTPServer "https://github.com/klsoundarya/tales-from-south-india/blob/main/.devcontainer/build-assets/http_server.py"
    click BuildAssets "https://github.com/klsoundarya/tales-from-south-india/tree/main/.devcontainer/build-assets/"
    click GitIgnore "https://github.com/klsoundarya/tales-from-south-india/blob/main/.gitignore"
    click README "https://github.com/klsoundarya/tales-from-south-india/blob/main/README.md"
    click CSS "https://github.com/klsoundarya/tales-from-south-india/blob/main/assests/css/styles.css"
    click Images "https://github.com/klsoundarya/tales-from-south-india/tree/main/assests/images/"
    click Video "https://github.com/klsoundarya/tales-from-south-india/blob/main/assests/video/ThankYou-bg-video.mp4"

    %% Styles
    classDef dev fill:#cce5ff,stroke:#004085
    classDef version fill:#d4edda,stroke:#155724
    classDef host fill:#ffe8cc,stroke:#cc7000
    classDef client fill:#fff8b8,stroke:#b5a700
```
