# krimsonjosh/portfolio architecture

> Architecture diagram of the GitHub repository krimsonjosh/portfolio, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-23). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/krimsonjosh/portfolio
- Repository: https://github.com/krimsonjosh/portfolio

## Overview

##### Project type and purpose
- This is a static-site portfolio built with Astro (an SSG framework).
- Purpose: compile `.astro` components, Markdown content and CSS into a static website for deployment.

##### File structure
- Top-level:
- astro.config.mjs, package.json, tsconfig.json → build/configuration files
- public/ → static assets (images, logos, favicon)
- src/
– components/ → reusable UI pieces (Header, Footer, Hero, etc.)
– layouts/ → page wrappers (BaseLayout, MarkdownPostLayout)
– pages/ → file-based routes (.astro pages and Markdown posts)
– scripts/ → client-side JS (menu toggling)
– styles/ → global CSS
- Patterns: component-based design, file-based routing, Markdown-as-content.

##### README
- Confirms basic Astro template, commands for dev, build and preview.
- No runtime server; everything is prebuilt into `/dist/`.

##### Detail
- Every top-level directory as a source input to the build process.
- Both static assets and generated assets.
- That the final output is entirely static, eliminating runtime servers.
- If using CI/CD, show build triggers on push/merge.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Developer and version control
    Dev["Developer Workstation"]:::infra
    Git["Git Repository"]:::infra
    CICD["CI/CD Pipeline"]:::infra
    %% Build and output
    subgraph "Astro Build Process"
        direction TB
        Parser["Markdown Parser"]:::process
        Compiler["Component Compiler"]:::process
        Renderer["Layout Renderer"]:::process
    end
    Dist["Generated Output (/dist/)"]:::content
    Hosting["Hosting / CDN"]:::infra
    Browser["End-User Browser"]:::client

    %% Source inputs
    subgraph "Source Code & Config"
        direction TB
        astroConfig["astro.config.mjs"]:::code
        packageJson["package.json"]:::code
        tsConfig["tsconfig.json"]:::code
        readme["README.md"]:::code
        gitignore[".gitignore"]:::code
        vscode[".vscode/"]:::code
    end

    subgraph "Content & Assets"
        direction TB
        publicAssets["public/"]:::content
        globalStyles["src/styles/global.css"]:::content
        menuJS["src/scripts/menu.js"]:::content

        subgraph "UI Components"
            direction TB
            HeaderComp["Header.astro"]:::code
            FooterComp["Footer.astro"]:::code
            HeroComp["Hero.astro"]:::code
            NavbarComp["Navbar.astro"]:::code
            HamburgerComp["Hamburger.astro"]:::code
            BlogPostComp["BlogPost.astro"]:::code
            ProjectCardComp["ProjectCard.astro"]:::code
            SkillsComp["Skills.astro"]:::code
            SocialComp["Social.astro"]:::code
            ContentContainerComp["ContentContainer.astro"]:::code
        end

        subgraph "Layouts"
            direction TB
            BaseLayout["BaseLayout.astro"]:::code
            MarkdownPostLayout["MarkdownPostLayout.astro"]:::code
        end

        subgraph "Page Routes"
            direction TB
            IndexPage["index.astro"]:::code
            AboutPage["about.astro"]:::code
            BlogPage["blog.astro"]:::code
            ProjectsPage["projects.astro"]:::code
        end

        subgraph "Markdown Content"
            direction TB
            Post1Md["post-1.md"]:::content
            Project1Md["project-1.md"]:::content
            Project3Md["project-3.md"]:::content
            Project4Md["project-4.md"]:::content
            Project5Md["project-5.md"]:::content
            Project6Md["project-6.md"]:::content
        end
    end

    %% Flow connections
    Dev -->|commits code & content| Git
    Git -->|push triggers| CICD
    CICD -->|runs npm install & build| Parser
    CICD --> Parser
    Parser --> Compiler
    Compiler --> Renderer
    Renderer --> District["Dist"]:::content
    Renderer --> Dist
    CICD -->|deploys output| Hosting
    Hosting -->|serves static site| Browser

    %% Source to build inputs
    astroConfig --> Parser
    packageJson --> Parser
    tsConfig --> Parser
    readme --> Parser
    gitignore --> Parser
    vscode --> Parser

    publicAssets --> Parser
    globalStyles --> Parser
    menuJS --> Parser

    HeaderComp --> Compiler
    FooterComp --> Compiler
    HeroComp --> Compiler
    NavbarComp --> Compiler
    HamburgerComp --> Compiler
    BlogPostComp --> Compiler
    ProjectCardComp --> Compiler
    SkillsComp --> Compiler
    SocialComp --> Compiler
    ContentContainerComp --> Compiler

    BaseLayout --> Renderer
    MarkdownPostLayout --> Renderer

    IndexPage --> Compiler
    AboutPage --> Compiler
    BlogPage --> Compiler
    ProjectsPage --> Compiler

    Post1Md --> Parser
    Project1Md --> Parser
    Project3Md --> Parser
    Project4Md --> Parser
    Project5Md --> Parser
    Project6Md --> Parser

    %% Click events
    click astroConfig "https://github.com/krimsonjosh/portfolio/blob/main/astro.config.mjs"
    click packageJson "https://github.com/krimsonjosh/portfolio/blob/main/package.json"
    click tsConfig "https://github.com/krimsonjosh/portfolio/blob/main/tsconfig.json"
    click readme "https://github.com/krimsonjosh/portfolio/blob/main/README.md"
    click gitignore "https://github.com/krimsonjosh/portfolio/blob/main/.gitignore"
    click vscode "https://github.com/krimsonjosh/portfolio/tree/main/.vscode/"
    click publicAssets "https://github.com/krimsonjosh/portfolio/tree/main/public/"
    click globalStyles "https://github.com/krimsonjosh/portfolio/blob/main/src/styles/global.css"
    click menuJS "https://github.com/krimsonjosh/portfolio/blob/main/src/scripts/menu.js"
    click HeaderComp "https://github.com/krimsonjosh/portfolio/blob/main/src/components/Header.astro"
    click FooterComp "https://github.com/krimsonjosh/portfolio/blob/main/src/components/Footer.astro"
    click HeroComp "https://github.com/krimsonjosh/portfolio/blob/main/src/components/Hero.astro"
    click NavbarComp "https://github.com/krimsonjosh/portfolio/blob/main/src/components/Navbar.astro"
    click HamburgerComp "https://github.com/krimsonjosh/portfolio/blob/main/src/components/Hamburger.astro"
    click BlogPostComp "https://github.com/krimsonjosh/portfolio/blob/main/src/components/BlogPost.astro"
    click ProjectCardComp "https://github.com/krimsonjosh/portfolio/blob/main/src/components/ProjectCard.astro"
    click SkillsComp "https://github.com/krimsonjosh/portfolio/blob/main/src/components/Skills.astro"
    click SocialComp "https://github.com/krimsonjosh/portfolio/blob/main/src/components/Social.astro"
    click ContentContainerComp "https://github.com/krimsonjosh/portfolio/blob/main/src/components/ContentContainer.astro"
    click BaseLayout "https://github.com/krimsonjosh/portfolio/blob/main/src/layouts/BaseLayout.astro"
    click MarkdownPostLayout "https://github.com/krimsonjosh/portfolio/blob/main/src/layouts/MarkdownPostLayout.astro"
    click IndexPage "https://github.com/krimsonjosh/portfolio/blob/main/src/pages/index.astro"
    click AboutPage "https://github.com/krimsonjosh/portfolio/blob/main/src/pages/about.astro"
    click BlogPage "https://github.com/krimsonjosh/portfolio/blob/main/src/pages/blog.astro"
    click ProjectsPage "https://github.com/krimsonjosh/portfolio/blob/main/src/pages/projects.astro"
    click Post1Md "https://github.com/krimsonjosh/portfolio/blob/main/src/pages/posts/post-1.md"
    click Project1Md "https://github.com/krimsonjosh/portfolio/blob/main/src/pages/projects/project-1.md"
    click Project3Md "https://github.com/krimsonjosh/portfolio/blob/main/src/pages/projects/project-3.md"
    click Project4Md "https://github.com/krimsonjosh/portfolio/blob/main/src/pages/projects/project-4.md"
    click Project5Md "https://github.com/krimsonjosh/portfolio/blob/main/src/pages/projects/project-5.md"
    click Project6Md "https://github.com/krimsonjosh/portfolio/blob/main/src/pages/projects/project-6.md"
    click Dist "https://github.com/krimsonjosh/portfolio/tree/main//dist/"

    %% Styles
    classDef code fill:#ADD8E6,stroke:#000
    classDef content fill:#90EE90,stroke:#000
    classDef infra fill:#FFA500,stroke:#000
    classDef process fill:#87CEEB,stroke:#000
    classDef client fill:#DDA0DD,stroke:#000
```
