# tom21-xd/landing-prometeondev architecture

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

- Interactive diagram: https://gitdiagram.com/tom21-xd/landing-prometeondev
- Repository: https://github.com/tom21-xd/landing-prometeondev

## Overview

##### Project type and purpose
- This is a static website built with Astro (an SSG framework).
- Purpose: a multi-page “business/portfolio” site with sections like Home, About, Services, Portfolio, Contact, Our Team.
- No runtime “backend” server—everything is pre-rendered at build time.

##### File structure
- Top level:
- public/ → static assets (images, videos, favicon).
- src/pages/ → file-based routing (.astro pages).
- src/components/ → UI components organized by page (atoms, molecules, organisms).
- src/layouts/ → shared layout(s).
- src/content/ → markdown data for projects.
- src/lib, src/utils → helper scripts.
- src/styles → global CSS.
- astro.config.mjs, tsconfig.json, package.json → configuration & dependencies.

##### Read README for insights
- Confirms basic Astro setup.
- No custom server or external API integrations mentioned.

##### Main components
a. Developer & Tooling
– Developer machine, VS Code, Terminal (npm / pnpm).
– Astro CLI & Node.js environment.
b. Source Code Layer
– src/pages: routing entry points.
– src/layouts: Layout.astro.
– src/components: design system (atoms, molecules, organisms).
– src/content: Markdown files → content layer.
– src/lib/utils.ts + src/utils/lenis.ts.
– src/styles/global.css.
c. Static Assets
– public/images, public/videos.
d. Build Process
– Astro build (reads config, runs Vite under the hood).
– Transforms .astro + MD → static HTML/CSS/JS.
– Bundles assets.
e. Output
– dist/ (or default output folder).
– Deployed to static host (e.g., Netlify, Vercel, GitHub Pages).
f. Browser (end user)
– Fetches pre-rendered HTML, CSS, JS.

##### Relationships & data flow
- Developer writes code → Astro CLI triggers build → reads source code and content → uses components + layouts to render pages → outputs static files → host serves to user’s browser.
- src/pages imports layouts + components; layouts may import global CSS; components may import utils.
- public/ assets are copied unchanged into the build output.

##### Architectural patterns & design principles
- Component-based design (Atomic Design: atoms, molecules, organisms).
- File-based routing.
- Static site generation (SSG).
- Separation of concerns: content (MD), presentation (.astro components), and assets.

##### Essentials
- Component boundaries: pages vs. layouts vs. components.
- Build toolchain: Astro CLI → Vite → output.
- Public assets path → served static.
- Deployment target (e.g., Static Host).

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Developer & Tooling
    subgraph "Developer & Tooling"
        Dev["Developer Machine"]:::developer
        IDE["VS Code"]:::developer
        Terminal["Terminal (npm/pnpm)"]:::developer
        Config["astro.config.mjs"]:::config
        TSConfig["tsconfig.json"]:::config
        PKG["package.json"]:::config
    end

    Dev --> IDE
    Dev --> Terminal
    Terminal --> AstroCLI

    click Config "https://github.com/tom21-xd/landing-prometeondev/blob/main/astro.config.mjs"
    click TSConfig "https://github.com/tom21-xd/landing-prometeondev/blob/main/tsconfig.json"
    click PKG "https://github.com/tom21-xd/landing-prometeondev/blob/main/package.json"

    AstroCLI["Astro CLI & Node.js"]:::process

    %% Source Code Layer
    subgraph "Source Code Layer"
        subgraph "Pages (Routing Entry Points)"
            Index["src/pages/index.astro"]:::pages
            About["src/pages/about.astro"]:::pages
            Services["src/pages/services.astro"]:::pages
            Portfolio["src/pages/portfolio.astro"]:::pages
            Contact["src/pages/contact.astro"]:::pages
            Team["src/pages/our-team.astro"]:::pages
        end

        Layout["src/layouts/Layout.astro"]:::layout

        subgraph "Components (Atomic Design)"
            GlobalAtoms["src/components/global"]:::components
            HomeComp["src/components/index"]:::components
            AboutComp["src/components/about"]:::components
            ServicesComp["src/components/services"]:::components
            PortfolioComp["src/components/portfolio"]:::components
            ContactComp["src/components/contact"]:::components
        end

        subgraph "Content (Markdown Data)"
            MD["src/content/projects/*.md"]:::content
        end

        Util["src/lib/utils.ts"]:::utils
        Lenis["src/utils/lenis.ts"]:::utils
        Styles["src/styles/global.css"]:::styles
    end

    click Index "https://github.com/tom21-xd/landing-prometeondev/blob/main/src/pages/index.astro"
    click About "https://github.com/tom21-xd/landing-prometeondev/blob/main/src/pages/about.astro"
    click Services "https://github.com/tom21-xd/landing-prometeondev/blob/main/src/pages/services.astro"
    click Portfolio "https://github.com/tom21-xd/landing-prometeondev/blob/main/src/pages/portfolio.astro"
    click Contact "https://github.com/tom21-xd/landing-prometeondev/blob/main/src/pages/contact.astro"
    click Team "https://github.com/tom21-xd/landing-prometeondev/blob/main/src/pages/our-team.astro"
    click Layout "https://github.com/tom21-xd/landing-prometeondev/blob/main/src/layouts/Layout.astro"
    click GlobalAtoms "https://github.com/tom21-xd/landing-prometeondev/tree/main/src/components/global"
    click HomeComp "https://github.com/tom21-xd/landing-prometeondev/tree/main/src/components/index"
    click AboutComp "https://github.com/tom21-xd/landing-prometeondev/tree/main/src/components/about"
    click ServicesComp "https://github.com/tom21-xd/landing-prometeondev/tree/main/src/components/services"
    click PortfolioComp "https://github.com/tom21-xd/landing-prometeondev/tree/main/src/components/portfolio"
    click ContactComp "https://github.com/tom21-xd/landing-prometeondev/tree/main/src/components/contact"
    click MD "https://github.com/tom21-xd/landing-prometeondev/blob/main/src/content/projects/*.md"
    click Util "https://github.com/tom21-xd/landing-prometeondev/blob/main/src/lib/utils.ts"
    click Lenis "https://github.com/tom21-xd/landing-prometeondev/blob/main/src/utils/lenis.ts"
    click Styles "https://github.com/tom21-xd/landing-prometeondev/blob/main/src/styles/global.css"

    %% Static Assets
    subgraph "Static Assets"
        Images["public/images"]:::assets
        Videos["public/videos"]:::assets
    end

    click Images "https://github.com/tom21-xd/landing-prometeondev/tree/main/public/images"
    click Videos "https://github.com/tom21-xd/landing-prometeondev/tree/main/public/videos"

    %% Build Process
    Build["Build Process (Astro build & Vite)"]:::process

    AstroCLI -->|"trigger build"| Build
    Config -->|"defines build & output"| Build
    Build -->|"reads source code"| Index
    Build -->|"reads source code"| About
    Build -->|"reads source code"| Services
    Build -->|"reads source code"| Portfolio
    Build -->|"reads source code"| Contact
    Build -->|"reads source code"| Team
    Build -->|"reads layouts & components"| Layout
    Build -->|"reads components"| GlobalAtoms
    Build -->|"reads content"| MD
    Images -->|"copied"| Build
    Videos -->|"copied"| Build
    Styles -->|"applied"| Build

    %% Relationships within Source Code
    Index -->|"import Layout, Components, Utils, Content"| Layout
    Index -->|"import Components"| HomeComp
    About -->|"import Layout, Components"| AboutComp
    Services -->|"import Layout, Components"| ServicesComp
    Portfolio -->|"import Layout, Content"| PortfolioComp
    Contact -->|"import Layout, Components"| ContactComp
    Team -->|"import Layout, Components"| GlobalAtoms
    Layout -->|"imports global.css"| Styles
    HomeComp --> Util
    AboutComp --> Util
    ServicesComp --> Util
    PortfolioComp --> Util
    ContactComp --> Util
    MD -->|"markdown → HTML"| Build
    Lenis --> Util

    %% Output & Deployment
    Dist["dist/"]:::output
    Build -->|"outputs static files"| Dist

    subgraph "Deployment"
        Host["Static Host (Netlify/Vercel/GH Pages)"]:::host
    end

    Dist -->|"deployed to"| Host
    Host -->|"serves pre-rendered site"| Browser

    Browser["End User Browser"]:::browser

    %% Styles
    classDef developer fill:#D6E9FE,stroke:#2B6CB0
    classDef config fill:#FFF9C4,stroke:#FDD835
    classDef process fill:#C8E6C9,stroke:#388E3C
    classDef pages fill:#F8BBD0,stroke:#D81B60
    classDef layout fill:#FFCCBC,stroke:#E64A19
    classDef components fill:#B2EBF2,stroke:#0097A7
    classDef content fill:#FFF3E0,stroke:#FB8C00
    classDef utils fill:#E1BEE7,stroke:#8E24AA
    classDef styles fill:#ECEFF1,stroke:#607D8B
    classDef assets fill:#FFF8E1,stroke:#FFB300
    classDef output fill:#CFD8DC,stroke:#455A64
    classDef host fill:#FFCDD2,stroke:#C62828
    classDef browser fill:#B2DFDB,stroke:#00796B
```
