# shamil-tp/portfolio. architecture

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

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

## Overview

shamiltp.me is a static portfolio whose central workflow selects a visual identity, mounts it over shared portfolio content, and links into case studies that retain that identity. The graph also captures the seeded variation system, the Depth design’s 3D scene, shared interactions and contact card, and the crawlable fallback. Unsampled design and case-study internals are represented only where the README documents their role; evidence paths cite those documented relationships.

Main entry points: [`js/interactions.js`](https://github.com/shamil-tp/portfolio./blob/main/js/interactions.js) (Shared Interactions), [`js/design-engine.js`](https://github.com/shamil-tp/portfolio./blob/main/js/design-engine.js) (Design Engine), [`js/case-main.js`](https://github.com/shamil-tp/portfolio./blob/main/js/case-main.js) (Case Study Runtime), [`js/generative-ui.js`](https://github.com/shamil-tp/portfolio./blob/main/js/generative-ui.js) (Variation Runtime)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_selection["Selection and Mounting"]
  node_boot["Design Boot<br/>[boot.js]"]
  node_registry["Design Registry<br/>[design-registry.js]"]
  node_main["Homepage Entry<br/>[main.js]"]
  node_engine["Design Engine<br/>[design-engine.js]"]
end

subgraph group_presentation["Portfolio Presentation"]
  node_designs["Design Modules"]
  node_blueprint["Blueprint Design<br/>[blueprint.js]"]
  node_depth["Depth Design<br/>[depth.js]"]
  node_scene["3D Maquette<br/>[depth-scene.js]"]
  node_garden["Garden Design<br/>[garden.js]"]
  node_generative["Generative Design<br/>[generative.js]"]
  node_os["Desktop OS Design<br/>[os.js]"]
  node_studio["Studio Design<br/>[studio.js]"]
end

subgraph group_variation["Generative Variations"]
  node_variation["Variation Runtime<br/>[generative-ui.js]"]
  node_presets["Variation Presets"]
  node_palette["Palette Generator"]
  node_layout["Layout Generator"]
end

subgraph group_cases["Case Studies"]
  node_casepages["Static Case Studies"]
  node_caseengine["Case Study Runtime<br/>[case-main.js]"]
  node_casecss["Identity Case Styles"]
end

subgraph group_shared["Shared Runtime"]
  node_content["Portfolio Content<br/>[content.js]"]
  node_helpers["Render Helpers<br/>[render-helpers.js]"]
  node_interactions["Shared Interactions<br/>[interactions.js]"]
  node_baseline["No-JS Baseline<br/>[baseline.js]"]
  node_contact["Contact Card<br/>[contact-card.js]"]
end

node_visitor(("Site Visitor"))
node_three["Three.js CDN"]

node_visitor -->|"visits"| node_boot
node_boot -->|"selects identity"| node_registry
node_boot -->|"starts module"| node_main
node_main -->|"starts"| node_engine
node_engine -->|"looks up designs"| node_registry
node_engine -->|"provides content"| node_content
node_engine -->|"provides helpers"| node_helpers
node_engine -->|"creates context"| node_interactions
node_engine -->|"loads and mounts"| node_designs
node_engine -.->|"loads when supported"| node_variation
node_designs -->|"opts into"| node_interactions
node_blueprint -->|"uses"| node_interactions
node_depth -->|"uses"| node_interactions
node_garden -->|"uses"| node_interactions
node_generative -->|"uses"| node_interactions
node_os -->|"uses"| node_interactions
node_studio -->|"uses"| node_interactions
node_depth -->|"sets up scene"| node_scene
node_depth -->|"loads on demand"| node_three
node_variation -->|"reads presets"| node_presets
node_variation -->|"validates palettes"| node_palette
node_variation -->|"chooses layouts"| node_layout
node_presets -->|"uses color math"| node_palette
node_helpers -->|"renders and initializes"| node_contact
node_baseline -->|"generates fallback from"| node_content
node_visitor -->|"opens case study"| node_casepages
node_casepages -.->|"enhances optionally"| node_caseengine
node_caseengine -->|"loads identity stylesheet"| node_casecss
node_casepages -->|"shares class vocabulary"| node_casecss
node_caseengine -.->|"applies visit variation"| node_variation
node_caseengine -->|"uses shared helpers"| node_helpers
node_caseengine -->|"uses shared behavior"| node_interactions

click node_boot "https://github.com/shamil-tp/portfolio./blob/main/js/boot.js"
click node_registry "https://github.com/shamil-tp/portfolio./blob/main/js/design-registry.js"
click node_main "https://github.com/shamil-tp/portfolio./blob/main/js/main.js"
click node_engine "https://github.com/shamil-tp/portfolio./blob/main/js/design-engine.js"
click node_content "https://github.com/shamil-tp/portfolio./blob/main/js/content.js"
click node_helpers "https://github.com/shamil-tp/portfolio./blob/main/js/render-helpers.js"
click node_interactions "https://github.com/shamil-tp/portfolio./blob/main/js/interactions.js"
click node_baseline "https://github.com/shamil-tp/portfolio./blob/main/js/baseline.js"
click node_contact "https://github.com/shamil-tp/portfolio./blob/main/js/contact-card.js"
click node_designs "https://github.com/shamil-tp/portfolio./tree/main/js/designs"
click node_blueprint "https://github.com/shamil-tp/portfolio./blob/main/js/designs/blueprint.js"
click node_depth "https://github.com/shamil-tp/portfolio./blob/main/js/designs/depth.js"
click node_scene "https://github.com/shamil-tp/portfolio./blob/main/js/designs/depth-scene.js"
click node_garden "https://github.com/shamil-tp/portfolio./blob/main/js/designs/garden.js"
click node_generative "https://github.com/shamil-tp/portfolio./blob/main/js/designs/generative.js"
click node_os "https://github.com/shamil-tp/portfolio./blob/main/js/designs/os.js"
click node_studio "https://github.com/shamil-tp/portfolio./blob/main/js/designs/studio.js"
click node_variation "https://github.com/shamil-tp/portfolio./blob/main/js/generative-ui.js"
click node_presets "https://github.com/shamil-tp/portfolio./blob/main/js/variation-presets.js"
click node_palette "https://github.com/shamil-tp/portfolio./blob/main/js/palette-generator.js"
click node_layout "https://github.com/shamil-tp/portfolio./blob/main/js/layout-generator.js"
click node_casepages "https://github.com/shamil-tp/portfolio./tree/main/myProjectDetails"
click node_caseengine "https://github.com/shamil-tp/portfolio./blob/main/js/case-main.js"
click node_casecss "https://github.com/shamil-tp/portfolio./tree/main/css"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_boot,node_registry,node_main,node_engine toneBlue
class node_designs,node_blueprint,node_depth,node_scene,node_garden,node_generative,node_os,node_studio toneAmber
class node_variation,node_presets,node_palette,node_layout toneMint
class node_casepages,node_caseengine,node_casecss toneRose
class node_content,node_helpers,node_interactions,node_baseline,node_contact,node_visitor,node_three toneIndigo
```

## Components

### Selection and Mounting

- [Design Boot](https://github.com/shamil-tp/portfolio./blob/main/js/boot.js): `js/boot.js`
- [Design Registry](https://github.com/shamil-tp/portfolio./blob/main/js/design-registry.js): `js/design-registry.js`
- [Homepage Entry](https://github.com/shamil-tp/portfolio./blob/main/js/main.js): `js/main.js`
- [Design Engine](https://github.com/shamil-tp/portfolio./blob/main/js/design-engine.js): `js/design-engine.js`

### Portfolio Presentation

- [Design Modules](https://github.com/shamil-tp/portfolio./tree/main/js/designs): `js/designs`
- [Blueprint Design](https://github.com/shamil-tp/portfolio./blob/main/js/designs/blueprint.js): `js/designs/blueprint.js`
- [Depth Design](https://github.com/shamil-tp/portfolio./blob/main/js/designs/depth.js): `js/designs/depth.js`
- [3D Maquette](https://github.com/shamil-tp/portfolio./blob/main/js/designs/depth-scene.js): `js/designs/depth-scene.js`
- [Garden Design](https://github.com/shamil-tp/portfolio./blob/main/js/designs/garden.js): `js/designs/garden.js`
- [Generative Design](https://github.com/shamil-tp/portfolio./blob/main/js/designs/generative.js): `js/designs/generative.js`
- [Desktop OS Design](https://github.com/shamil-tp/portfolio./blob/main/js/designs/os.js): `js/designs/os.js`
- [Studio Design](https://github.com/shamil-tp/portfolio./blob/main/js/designs/studio.js): `js/designs/studio.js`

### Generative Variations

- [Variation Runtime](https://github.com/shamil-tp/portfolio./blob/main/js/generative-ui.js): `js/generative-ui.js`
- [Variation Presets](https://github.com/shamil-tp/portfolio./blob/main/js/variation-presets.js): `js/variation-presets.js`
- [Palette Generator](https://github.com/shamil-tp/portfolio./blob/main/js/palette-generator.js): `js/palette-generator.js`
- [Layout Generator](https://github.com/shamil-tp/portfolio./blob/main/js/layout-generator.js): `js/layout-generator.js`

### Case Studies

- [Static Case Studies](https://github.com/shamil-tp/portfolio./tree/main/myProjectDetails): `myProjectDetails`
- [Case Study Runtime](https://github.com/shamil-tp/portfolio./blob/main/js/case-main.js): `js/case-main.js`
- [Identity Case Styles](https://github.com/shamil-tp/portfolio./tree/main/css): `css`

### Shared Runtime

- [Portfolio Content](https://github.com/shamil-tp/portfolio./blob/main/js/content.js): `js/content.js`
- [Render Helpers](https://github.com/shamil-tp/portfolio./blob/main/js/render-helpers.js): `js/render-helpers.js`
- [Shared Interactions](https://github.com/shamil-tp/portfolio./blob/main/js/interactions.js): `js/interactions.js`
- [No-JS Baseline](https://github.com/shamil-tp/portfolio./blob/main/js/baseline.js): `js/baseline.js`
- [Contact Card](https://github.com/shamil-tp/portfolio./blob/main/js/contact-card.js): `js/contact-card.js`

### Other components

- **Site Visitor**
- **Three.js CDN**

## Connections

- Site Visitor → Design Boot: visits (evidence: `README.md`)
- Design Boot → Design Registry: selects identity (evidence: `README.md`)
- Design Boot → Homepage Entry: starts module (evidence: `README.md`)
- Homepage Entry → Design Engine: starts (evidence: `js/main.js`)
- Design Engine → Design Registry: looks up designs (evidence: `README.md`)
- Design Engine → Portfolio Content: provides content (evidence: `js/design-engine.js`)
- Design Engine → Render Helpers: provides helpers (evidence: `js/design-engine.js`)
- Design Engine → Shared Interactions: creates context (evidence: `js/design-engine.js`)
- Design Engine → Design Modules: loads and mounts (evidence: `README.md`)
- Design Engine → Variation Runtime: loads when supported (evidence: `js/design-engine.js`)
- Design Modules → Shared Interactions: opts into (evidence: `README.md`)
- Blueprint Design → Shared Interactions: uses (evidence: `js/designs/blueprint.js`)
- Depth Design → Shared Interactions: uses (evidence: `js/designs/depth.js`)
- Garden Design → Shared Interactions: uses (evidence: `js/designs/garden.js`)
- Generative Design → Shared Interactions: uses (evidence: `js/designs/generative.js`)
- Desktop OS Design → Shared Interactions: uses (evidence: `js/designs/os.js`)
- Studio Design → Shared Interactions: uses (evidence: `js/designs/studio.js`)
- Depth Design → 3D Maquette: sets up scene (evidence: `js/designs/depth.js`)
- Depth Design → Three.js CDN: loads on demand (evidence: `README.md`)
- Variation Runtime → Variation Presets: reads presets (evidence: `js/generative-ui.js`)
- Variation Runtime → Palette Generator: validates palettes (evidence: `js/generative-ui.js`)
- Variation Runtime → Layout Generator: chooses layouts (evidence: `js/generative-ui.js`)
- Variation Presets → Palette Generator: uses color math (evidence: `js/variation-presets.js`)
- Render Helpers → Contact Card: renders and initializes (evidence: `js/render-helpers.js`)
- No-JS Baseline → Portfolio Content: generates fallback from (evidence: `README.md`)
- Site Visitor → Static Case Studies: opens case study (evidence: `README.md`)
- Static Case Studies → Case Study Runtime: enhances optionally (evidence: `README.md`)
- Case Study Runtime → Identity Case Styles: loads identity stylesheet (evidence: `README.md`)
- Static Case Studies → Identity Case Styles: shares class vocabulary (evidence: `README.md`)
- Case Study Runtime → Variation Runtime: applies visit variation (evidence: `js/case-main.js`)
- Case Study Runtime → Render Helpers: uses shared helpers (evidence: `js/case-main.js`)
- Case Study Runtime → Shared Interactions: uses shared behavior (evidence: `js/case-main.js`)
