# tanishkthoria/personal-website architecture

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

- Interactive diagram: https://gitdiagram.com/tanishkthoria/personal-website
- Repository: https://github.com/tanishkthoria/personal-website

## Overview

##### Main Components
- Content Management – The “content” folder holds the markdown files (posts, pages such as about.md, contact.md, etc.) which represent the website’s content.
- Configuration & Metadata – The “config.toml” file contains the global configuration for the Hugo site, including settings for themes, menus, taxonomies, and build parameters.
- Theme Components – The “themes” directory (particularly the Hugo-Programmer theme) contains the layout templates, partials, and styling (CSS/SCSS) that dictate the website’s look and feel.
- Assets & Resources – The “resources” folder holds generated assets (CSS/JS) that are compiled from source (e.g., SCSS) and optimized by Hugo.
- Build Outputs – The “public” folder and alternate “isableFastRender” folder contain the pre-built static files (HTML, CSS, JS, images, etc.) that will be deployed.
- Deployment – The “netlify.toml” file and badges in the README indicate that Netlify handles the build/deploy process.
- Auxiliary/Supporting Files – The “archetypes” (default page/template definitions) and other configuration/log files help manage content creation and site behavior.

##### Out Relationships and Interactions
- The Content Layer: The “content” folder provides the website’s textual data (posts, pages, etc.).
- The Configuration Layer: “config.toml” and archetypes define the project’s settings and behavior.
- The Presentation Layer: The “themes” directory supplies templates, layouts, and styling which the Hugo engine uses to render the content.
- The Build Process: Hugo, as the static site generator, reads the content and configuration, applies the theme/templates, and produces the final static files stored in “public” (or “isableFastRender”).
- The Deployment: Once built, the static assets are deployed (via Netlify or a similar service) to be served as the live website.

##### Architectural Patterns and Technology Use
- Static Site Generation – The system follows a build pipeline where content and configuration are compiled into static files.
- Separation of Concerns – The content (Markdown files), configurations (config.toml, archetypes), and presentation (themes, assets) are clearly separated into distinct directories.
- Modular Theming – The use of an external theme (Hugo-Programmer) simplifies maintenance and modular development.
- Build & Deployment Automation – With Netlify configuration and a dedicated branch for testing (as per the README), continuous deployment and version control practices are evident.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Source Repository"
        C1["Content (Markdown Files)"]:::content
        C2["Config (config.toml)"]:::config
        C3["Archetypes"]:::config
        T1["Theme (Hugo-Programmer)"]:::theme
        R1["Assets & Resources"]:::asset
    end

    H["Hugo Build Engine"]:::build

    C1 --> H
    C2 --> H
    C3 --> H
    T1 --> H
    R1 --> H

    subgraph "Build Outputs"
        B1["Static Files (public)"]:::buildOut
        B2["Fast Render Files (isableFastRender)"]:::buildOut
    end

    H --> B1
    H --> B2

    D1["Deployment (Netlify)"]:::deployment

    B1 --> D1
    B2 --> D1

    click C1 "https://github.com/tanishkthoria/personal-website/tree/main/content"
    click C2 "https://github.com/tanishkthoria/personal-website/blob/main/config.toml"
    click C3 "https://github.com/tanishkthoria/personal-website/tree/main/archetypes"
    click T1 "https://github.com/tanishkthoria/personal-website/tree/main/themes/Hugo-Programmer"
    click R1 "https://github.com/tanishkthoria/personal-website/tree/main/resources"
    click B1 "https://github.com/tanishkthoria/personal-website/tree/main/public"
    click B2 "https://github.com/tanishkthoria/personal-website/tree/main/isableFastRender"
    click D1 "https://github.com/tanishkthoria/personal-website/blob/main/netlify.toml"

    classDef content fill:#fdecbb,stroke:#333,stroke-width:2px;
    classDef config fill:#c8f7c5,stroke:#333,stroke-width:2px;
    classDef theme fill:#cfe2f3,stroke:#333,stroke-width:2px;
    classDef asset fill:#f2d7ee,stroke:#333,stroke-width:2px;
    classDef build fill:#ffe4b5,stroke:#333,stroke-width:2px;
    classDef buildOut fill:#d0e9c6,stroke:#333,stroke-width:2px;
    classDef deployment fill:#f4cccc,stroke:#333,stroke-width:2px;
```
