# longphanquangminh/new-contest-portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/longphanquangminh/new-contest-portfolio
- Repository: https://github.com/longphanquangminh/new-contest-portfolio

## Overview

##### Main Components
- Vite Configuration and Build Process: The vite.config.ts file and related configuration files (tsconfig.json, tsconfig.app.json, tsconfig.node.json, bun.lock, package.json) encapsulate the build and dependency management aspects. These can be depicted as “Build/Development Tools Configuration”.
- Source Code (src Directory): This contains the core React application logic:
- Main entry: src/main.tsx, which bootstraps the application.
- Global Styling: Files like index.css and Home.css.
- Components: A rich collection of UI components organized further under subdirectories (e.g., aurora, gradient-text, iridescence, pixel-transition, scroll-velocity, split-text). These represent reusable UI pieces that can be shown as a group labeled “UI Components”.
- Views/Sections: Files under src/sections (like Contact.tsx & Projects.tsx) that represent different application pages or sections.
- README & ESLint Configuration: Although not part of the running system, the README and ESLint notes are vital for developers and show that there’s an emphasis on code quality and consistency. They can be noted briefly as “Developer Guidelines & Tooling”.

##### Depicting Relationships and Interactions
- How the entry point (index.html) loads the bundled React application.
- “Entry HTML” to the “React Application” (i.e., main.tsx) that then loads various UI Components.
- That UI Components (nested and categorized) are used by higher-level sections (Contact, Projects, etc.) to build up the pages.
- That the Vite build system processes TypeScript and JSX files, transforming the source into a production-ready bundle.
- Optionally, note that plugin configuration (@vitejs/plugin-react and/or @vitejs/plugin-react-swc) is used to enable Fast Refresh during development.

##### Architectural Patterns and Design Principles
- Separation of Concerns: Clearly separate the roles of static assets (Public), application bootstrap (index.html, main.tsx), UI logic (src/components, src/sections), and configuration/build processes.
- Modular Organization: Components are grouped by functionality (e.g., aurora, gradient-text, etc.), suggesting a modular design that facilitates maintenance and scaling of the user interface.

## Diagram (Mermaid)

```mermaid
graph TD
    Browser["Browser"]:::frontend
    StaticHTML["Static Assets & Entry HTML"]:::static
    BootStrap["App Entry & Bootstrapping"]:::app
    GlobalStyling["Global Styling & Views"]:::app
    UIComponents["UI Components (aurora, gradient-text, iridescence, pixel-transition, scroll-velocity, split-text)"]:::component
    PageSections["Page Sections/Views (Contact, Projects)"]:::component
    BuildTools["Build/Development Tools Configuration"]:::build
    DevGuidelines["Developer Guidelines & Tooling"]:::dev

    Browser -->|"LoadAssets"| StaticHTML
    StaticHTML -->|"BootstrapApp"| BootStrap
    BootStrap -->|"ApplyStyles"| GlobalStyling
    BootStrap -->|"RenderUI"| UIComponents
    UIComponents -->|"ComposePages"| PageSections
    GlobalStyling -->|"EnhanceUI"| PageSections
    BuildTools -->|"ConfigureApp"| BootStrap
    BuildTools -->|"TransformUI"| UIComponents
    DevGuidelines -->|"GuideDev"| BuildTools

    click StaticHTML "https://github.com/longphanquangminh/new-contest-portfolio/blob/master/index.html"
    click StaticHTML "https://github.com/longphanquangminh/new-contest-portfolio/tree/master/public/"
    click BootStrap "https://github.com/longphanquangminh/new-contest-portfolio/blob/master/src/main.tsx"
    click BootStrap "https://github.com/longphanquangminh/new-contest-portfolio/blob/master/src/index.css"
    click GlobalStyling "https://github.com/longphanquangminh/new-contest-portfolio/blob/master/src/Home.css"
    click GlobalStyling "https://github.com/longphanquangminh/new-contest-portfolio/blob/master/src/Home.tsx"
    click UIComponents "https://github.com/longphanquangminh/new-contest-portfolio/tree/master/src/components/"
    click PageSections "https://github.com/longphanquangminh/new-contest-portfolio/blob/master/src/sections/Contact.tsx"
    click PageSections "https://github.com/longphanquangminh/new-contest-portfolio/blob/master/src/sections/Projects.tsx"
    click BuildTools "https://github.com/longphanquangminh/new-contest-portfolio/blob/master/vite.config.ts"
    click BuildTools "https://github.com/longphanquangminh/new-contest-portfolio/blob/master/tsconfig.json"
    click BuildTools "https://github.com/longphanquangminh/new-contest-portfolio/blob/master/tsconfig.app.json"
    click BuildTools "https://github.com/longphanquangminh/new-contest-portfolio/blob/master/tsconfig.node.json"
    click BuildTools "https://github.com/longphanquangminh/new-contest-portfolio/blob/master/bun.lock"
    click BuildTools "https://github.com/longphanquangminh/new-contest-portfolio/blob/master/package.json"
    click DevGuidelines "https://github.com/longphanquangminh/new-contest-portfolio/blob/master/README.md"
    click DevGuidelines "https://github.com/longphanquangminh/new-contest-portfolio/blob/master/.gitignore"

    classDef static fill:#E0F7FA,stroke:#006064,stroke-width:2px;
    classDef app fill:#FFECB3,stroke:#FF6F00,stroke-width:2px;
    classDef component fill:#C8E6C9,stroke:#2E7D32,stroke-width:2px;
    classDef build fill:#F8BBD0,stroke:#AD1457,stroke-width:2px;
    classDef dev fill:#D1C4E9,stroke:#512DA8,stroke-width:2px;
    classDef frontend fill:#BBDEFB,stroke:#0D47A1,stroke-width:2px;
```
