# amangupta5555/portfolio-website architecture

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

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

## Overview

##### Main Components
- index.html – This is your entry HTML file and likely the main webpage that links to your CSS.
- CSS Directory – This folder is organized into two sub-directories:
◦ CSS/src/input.css – The source CSS file where you write Tailwind directives and your custom styles.
◦ CSS/output/output.css – The compiled CSS file generated after processing the source with Tailwind.
- tailwind.config.js – This configuration file defines your Tailwind CSS setup (themes, plugins, variants, etc.) and controls how Tailwind processes your CSS.
- package.json & package-lock.json – These files contain project dependencies and scripts. They likely configure the build process (e.g., using a Tailwind CLI or a bundler) to convert CSS/src into CSS/output.
- .gitignore – Lists files/folders (like node_modules, build files, etc.) that should not be committed to version control.

##### Relationships and Interactions
- The Build Process: It is crucial to highlight that there is a CSS pre-processing pipeline. The CSS/src/input.css, in combination with tailwind.config.js, is processed (possibly using a build script defined in package.json) to generate the final CSS file (CSS/output/output.css).
- Dependency Management: package.json is used to manage dependencies (like the Tailwind CSS library) that impact how the build process works. This indicates the integration of third-party tools.
- Frontend Integration: The index.html file likely references the CSS/output/output.css to apply the styles to the webpage.

##### Important Architectural Patterns and Technologies
- Build Pipeline Pattern: Clearly depicting how source files are transformed (via Tailwind configuration and CLI or build scripts) into output files.
- Separation of Concerns: Source CSS remains in CSS/src while the generated and deployable assets are in CSS/output, maintaining clarity between development and production stages.
- Use of Tailwind CSS: Tailwind acts as both a utility-first CSS framework and a build tool when combined with its configuration file.
- Dependency Management with npm: package.json defines the project’s ecosystem and scripts.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Build Pipeline"
        INPUT["index.html:CSS/src/input.css"]:::source
        BUILD["Tailwind Build Process"]:::build
        OUTPUT["index.html:CSS/output/output.css"]:::output
        INPUT -->|"TailwindBuildProcess"| BUILD
        BUILD -->|"Produces"| OUTPUT
        CONFIG["tailwind.config.js"]:::config
        DEP["package.json & package-lock.json"]:::dependency
        CONFIG -->|"Configures"| BUILD
        DEP -->|"Manages"| BUILD
        GIT[".gitignore"]:::ignored
    end

    subgraph "Frontend"
        HTML["index.html"]:::html
    end

    OUTPUT -->|"LinkedTo"| HTML

    click HTML "https://github.com/amangupta5555/portfolio-website/blob/main/index.html"
    click INPUT "https://github.com/amangupta5555/portfolio-website/blob/main/CSS/src/input.css"
    click OUTPUT "https://github.com/amangupta5555/portfolio-website/blob/main/CSS/output/output.css"
    click CONFIG "https://github.com/amangupta5555/portfolio-website/blob/main/tailwind.config.js"
    click DEP "https://github.com/amangupta5555/portfolio-website/blob/main/package.json"
    click GIT "https://github.com/amangupta5555/portfolio-website/blob/main/.gitignore"

    classDef html fill:#FFDDC1,stroke:#B0413E,stroke-width:2px;
    classDef source fill:#C1E1FF,stroke:#2B5DFF,stroke-width:2px;
    classDef build fill:#FFF2CC,stroke:#E69138,stroke-width:2px;
    classDef output fill:#D9EAD3,stroke:#6AA84F,stroke-width:2px;
    classDef config fill:#EAD1DC,stroke:#9900FF,stroke-width:2px;
    classDef dependency fill:#FFF0F0,stroke:#FF0000,stroke-width:2px;
    classDef ignored fill:#E7E6E6,stroke:#A4A4A4,stroke-width:2px;
```
