# juserdev/personal-landing-page architecture

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

- Interactive diagram: https://gitdiagram.com/juserdev/personal-landing-page
- Repository: https://github.com/juserdev/personal-landing-page

## Overview

##### Project type and purpose
- This is a static, front-end “landing page” website hosted on GitHub Pages. Its purpose is to showcase completed Frontend Mentor challenges in organized sections (HTML/CSS challenges, JavaScript/TypeScript challenges, intermediate challenges). There is no server-side component or database; all content is delivered as static assets.

##### File structure
- Top-level assets
- index.html, style.css (global styles), code.ts/js, tsconfig.json, package.json → root landing page and TS build config
- node_modules/ and package.json → local TS/JS tooling (TypeScript compiler, possible bundler)
- Sections
- /retos-html/ → HTML & CSS challenge gallery (app.ts/js + data.json drive dynamic menu)
- /retos-intermedios/ → intermediate challenge gallery (app.ts/js + intermediate.json)
- /retos-js-ts/ → JavaScript & TypeScript challenge gallery (app.ts/js + data.json)
- Inside each section: HTML pages, CSS (Style.css), code.js / code.ts, JSON data, design and images subfolders.

##### README for additional insights
- Confirms static nature, responsive design, modular folder structure, and use of JSON to drive page content dynamically via client-side scripts.

##### Detail and thoroughness
- JSON data flow into the client-side scripts
- One-way pipeline from source files to end user
- Don’t over-optimize: more components (workstation, build, repo, host, browser, data) make it clearer how the static site is produced and consumed.

## Diagram (Mermaid)

```mermaid
flowchart TB
  %% Developer Workstation & Toolchain
  subgraph "Developer Workstation & Toolchain"
    direction TB
    TSConfig["tsconfig.json"]:::build
    Pkg["package.json"]:::build
    NodeMod["node_modules/"]:::build
    CodeTS["code.ts"]:::build
    CodeJS["code.js"]:::build
  end

  %% Version Control & CI/CD
  subgraph "Version Control & CI/CD (GitHub Repository)"
    direction TB
    GITIGNORE[".gitignore"]:::deploy
    LICENSE["LICENSE"]:::deploy
    README["readme.md"]:::deploy
  end

  %% Static File Host
  subgraph "Static File Host (GitHub Pages CDN)"
    direction TB
    Index["index.html"]:::deploy
    Style["style.css"]:::deploy
    Imgs["imgs/"]:::deploy
    subgraph "HTML & CSS Challenges Module"
      direction TB
      RHTML["retos-html/retos-html.html"]:::runtime
      AppTS_HTML["retos-html/app.ts"]:::runtime
      AppJS_HTML["retos-html/app.js"]:::runtime
      FoldersHTML["retos-html/retos/"]:::runtime
    end
    subgraph "Intermediate Challenges Module"
      direction TB
      RIHTML["retos-intermedios/retos-intermedios.html"]:::runtime
      AppTS_INT["retos-intermedios/app.ts"]:::runtime
      AppJS_INT["retos-intermedios/app.js"]:::runtime
      FoldersINT["retos-intermedios/retos/"]:::runtime
    end
    subgraph "JavaScript & TypeScript Challenges Module"
      direction TB
      RJSHTML["retos-js-ts/retos-js-ts.html"]:::runtime
      AppTS_JS["retos-js-ts/app.ts"]:::runtime
      AppJS_JS["retos-js-ts/app.js"]:::runtime
      FoldersJS["retos-js-ts/retos/"]:::runtime
    end
  end

  %% JSON Data Store
  subgraph "JSON Data Store"
    direction TB
    DataHTML["retos-html/data.json"]:::data
    DataINT["retos-intermedios/intermediate.json"]:::data
    DataJS["retos-js-ts/data.json"]:::data
  end

  %% Browser
  subgraph "Web Browser (Client)"
    direction TB
    Browser["Browser"]
  end

  %% Connections
  TSConfig -->|"configured by"| CodeTS
  CodeTS -->|"compiled to"| CodeJS
  CodeJS -->|"packaged via npm scripts"| Pkg
  NodeMod --> Pkg
  Pkg -->|"push to repo"| GITIGNORE
  LICENSE --> README
  README -->|"repository"| Index
  Index -->|"serves modules"| RHTML
  Index -->|"serves modules"| RIHTML
  Index -->|"serves modules"| RJSHTML
  Browser -->|"GET static assets"| Index
  Browser -->|"fetch JSON"| DataHTML
  Browser -->|"fetch JSON"| DataINT
  Browser -->|"fetch JSON"| DataJS
  RHTML -->|"loads app script"| AppJS_HTML
  RIHTML -->|"loads app script"| AppJS_INT
  RJSHTML -->|"loads app script"| AppJS_JS

  %% Click Events
  click TSConfig "https://github.com/juserdev/personal-landing-page/blob/main/tsconfig.json"
  click Pkg "https://github.com/juserdev/personal-landing-page/blob/main/package.json"
  click NodeMod "https://github.com/juserdev/personal-landing-page/tree/main/node_modules/"
  click CodeTS "https://github.com/juserdev/personal-landing-page/blob/main/code.ts"
  click CodeJS "https://github.com/juserdev/personal-landing-page/blob/main/code.js"
  click GITIGNORE "https://github.com/juserdev/personal-landing-page/blob/main/.gitignore"
  click LICENSE "https://github.com/juserdev/personal-landing-page/tree/main/LICENSE"
  click README "https://github.com/juserdev/personal-landing-page/blob/main/readme.md"
  click Index "https://github.com/juserdev/personal-landing-page/blob/main/index.html"
  click Style "https://github.com/juserdev/personal-landing-page/blob/main/style.css"
  click Imgs "https://github.com/juserdev/personal-landing-page/tree/main/imgs/"
  click RHTML "https://github.com/juserdev/personal-landing-page/blob/main/retos-html/retos-html.html"
  click AppTS_HTML "https://github.com/juserdev/personal-landing-page/blob/main/retos-html/app.ts"
  click AppJS_HTML "https://github.com/juserdev/personal-landing-page/blob/main/retos-html/app.js"
  click FoldersHTML "https://github.com/juserdev/personal-landing-page/tree/main/retos-html/retos/"
  click RIHTML "https://github.com/juserdev/personal-landing-page/blob/main/retos-intermedios/retos-intermedios.html"
  click AppTS_INT "https://github.com/juserdev/personal-landing-page/blob/main/retos-intermedios/app.ts"
  click AppJS_INT "https://github.com/juserdev/personal-landing-page/blob/main/retos-intermedios/app.js"
  click FoldersINT "https://github.com/juserdev/personal-landing-page/tree/main/retos-intermedios/retos/"
  click RJSHTML "https://github.com/juserdev/personal-landing-page/blob/main/retos-js-ts/retos-js-ts.html"
  click AppTS_JS "https://github.com/juserdev/personal-landing-page/blob/main/retos-js-ts/app.ts"
  click AppJS_JS "https://github.com/juserdev/personal-landing-page/blob/main/retos-js-ts/app.js"
  click FoldersJS "https://github.com/juserdev/personal-landing-page/tree/main/retos-js-ts/retos/"
  click DataHTML "https://github.com/juserdev/personal-landing-page/blob/main/retos-html/data.json"
  click DataINT "https://github.com/juserdev/personal-landing-page/blob/main/retos-intermedios/intermediate.json"
  click DataJS "https://github.com/juserdev/personal-landing-page/blob/main/retos-js-ts/data.json"

  %% Styles
  classDef build fill:#f0f0f0,stroke:#333,stroke-width:1px
  classDef deploy fill:#ddeeff,stroke:#000,stroke-width:1px
  classDef runtime fill:#ddffdd,stroke:#333,stroke-width:1px
  classDef data fill:#ffddee,stroke:#333,stroke-width:1px
```
