# miftahul-islam-efaz/brud-code architecture

> Architecture diagram of the GitHub repository miftahul-islam-efaz/brud-code, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/miftahul-islam-efaz/brud-code
- Repository: https://github.com/miftahul-islam-efaz/brud-code

## Overview

Brud Code Website is a marketing landing page for a VS Code extension, not the extension runtime. Its principal visitor journey is to learn the promise, understand installation and capabilities, follow a documented chatbot-to-Brud workflow, then consult FAQs or follow the install call to action. The page composes these sections; shared layout adds scrolling and reveal behavior. The archived 3D hero prototype is not part of the main site flow. Relationships below are limited to page composition, indexed imports, excerpts, and README statements.

Main entry points: [`src/app/page.js`](https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/app/page.js) (Home page), [`src/app/layout.js`](https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/app/layout.js) (Shared layout), [`src/components/guide/GuideSection.jsx`](https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/components/guide/GuideSection.jsx) (Guide section), [`src/components/hero/Hero.jsx`](https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/components/hero/Hero.jsx) (Hero section)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_landing["Landing page"]
  node_home["Home page<br/>[page.js]"]
end

subgraph group_messaging["Product messaging"]
  node_hero["Hero section<br/>[Hero.jsx]"]
  node_hero_nav["Hero navigation<br/>[HeroNav.jsx]"]
  node_hero_copy["Hero content<br/>[hero.js]"]
  node_install["Install section<br/>[InstallSection.jsx]"]
  node_install_copy["Install content<br/>[install.js]"]
  node_features["Feature section"]
  node_benchmark["Benchmark chart<br/>[BenchmarkChart.jsx]"]
  node_faq["FAQ section<br/>[FaqSection.jsx]"]
  node_faq_copy["FAQ content<br/>[faq.js]"]
  node_footer["Footer section<br/>[FooterSection.jsx]"]
  node_footer_copy["Footer content<br/>[footer.js]"]
end

subgraph group_walkthrough["Walkthrough"]
  node_guide["Guide section<br/>[GuideSection.jsx]"]
  node_guide_copy["Guide steps<br/>[guide.js]"]
  node_lightbox["Guide lightbox<br/>[GuideLightbox.jsx]"]
end

subgraph group_experience["Site experience"]
  node_journey["Scroll journey<br/>[Journey.jsx]"]
  node_layout["Shared layout<br/>[layout.js]"]
  node_smooth_anchors["Smooth anchors<br/>[SmoothAnchors.jsx]"]
  node_smooth_scroll["Smooth scrolling<br/>[SmoothScroll.jsx]"]
  node_scroll_reveal["Scroll reveals<br/>[ScrollReveal.jsx]"]
  node_mark_geometry["Brand geometry<br/>[markGeometry.js]"]
end

node_visitor(("Site visitor"))

node_visitor -->|"visits"| node_home
node_home -->|"renders"| node_hero
node_home -->|"wraps hero"| node_journey
node_home -->|"renders"| node_install
node_home -->|"renders"| node_features
node_home -->|"renders"| node_guide
node_home -->|"renders"| node_faq
node_home -->|"renders"| node_footer
node_hero -->|"renders"| node_hero_nav
node_hero_nav -->|"reads"| node_hero_copy
node_install -->|"reads"| node_install_copy
node_features -->|"renders"| node_benchmark
node_guide -->|"reads"| node_guide_copy
node_guide -->|"opens"| node_lightbox
node_faq -->|"reads"| node_faq_copy
node_footer -->|"reads"| node_footer_copy
node_journey -->|"uses geometry"| node_mark_geometry
node_layout -->|"renders"| node_smooth_anchors
node_layout -->|"renders"| node_smooth_scroll
node_layout -->|"renders"| node_scroll_reveal

click node_home "https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/app/page.js"
click node_hero "https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/components/hero/Hero.jsx"
click node_hero_nav "https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/components/hero/HeroNav.jsx"
click node_hero_copy "https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/content/hero.js"
click node_journey "https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/components/journey/Journey.jsx"
click node_install "https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/components/install/InstallSection.jsx"
click node_install_copy "https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/content/install.js"
click node_features "https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/components/features/FeaturesSection.jsx"
click node_benchmark "https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/components/features/BenchmarkChart.jsx"
click node_guide "https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/components/guide/GuideSection.jsx"
click node_guide_copy "https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/content/guide.js"
click node_lightbox "https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/components/guide/GuideLightbox.jsx"
click node_faq "https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/components/faq/FaqSection.jsx"
click node_faq_copy "https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/content/faq.js"
click node_footer "https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/components/footer/FooterSection.jsx"
click node_footer_copy "https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/content/footer.js"
click node_layout "https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/app/layout.js"
click node_smooth_anchors "https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/components/SmoothAnchors.jsx"
click node_smooth_scroll "https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/components/motion/SmoothScroll.jsx"
click node_scroll_reveal "https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/components/motion/ScrollReveal.jsx"
click node_mark_geometry "https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/components/brand/markGeometry.js"

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_home toneBlue
class node_hero,node_hero_nav,node_hero_copy,node_install,node_install_copy,node_features,node_benchmark,node_faq,node_faq_copy,node_footer,node_footer_copy toneAmber
class node_guide,node_guide_copy,node_lightbox toneMint
class node_journey,node_layout,node_smooth_anchors,node_smooth_scroll,node_scroll_reveal,node_mark_geometry toneRose
class node_visitor toneIndigo
```

## Components

### Landing page

- [Home page](https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/app/page.js): `src/app/page.js`

### Product messaging

- [Hero section](https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/components/hero/Hero.jsx): `src/components/hero/Hero.jsx`
- [Hero navigation](https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/components/hero/HeroNav.jsx): `src/components/hero/HeroNav.jsx`
- [Hero content](https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/content/hero.js): `src/content/hero.js`
- [Install section](https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/components/install/InstallSection.jsx): `src/components/install/InstallSection.jsx`
- [Install content](https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/content/install.js): `src/content/install.js`
- [Feature section](https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/components/features/FeaturesSection.jsx): `src/components/features/FeaturesSection.jsx`
- [Benchmark chart](https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/components/features/BenchmarkChart.jsx): `src/components/features/BenchmarkChart.jsx`
- [FAQ section](https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/components/faq/FaqSection.jsx): `src/components/faq/FaqSection.jsx`
- [FAQ content](https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/content/faq.js): `src/content/faq.js`
- [Footer section](https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/components/footer/FooterSection.jsx): `src/components/footer/FooterSection.jsx`
- [Footer content](https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/content/footer.js): `src/content/footer.js`

### Walkthrough

- [Guide section](https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/components/guide/GuideSection.jsx): `src/components/guide/GuideSection.jsx`
- [Guide steps](https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/content/guide.js): `src/content/guide.js`
- [Guide lightbox](https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/components/guide/GuideLightbox.jsx): `src/components/guide/GuideLightbox.jsx`

### Site experience

- [Scroll journey](https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/components/journey/Journey.jsx): `src/components/journey/Journey.jsx`
- [Shared layout](https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/app/layout.js): `src/app/layout.js`
- [Smooth anchors](https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/components/SmoothAnchors.jsx): `src/components/SmoothAnchors.jsx`
- [Smooth scrolling](https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/components/motion/SmoothScroll.jsx): `src/components/motion/SmoothScroll.jsx`
- [Scroll reveals](https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/components/motion/ScrollReveal.jsx): `src/components/motion/ScrollReveal.jsx`
- [Brand geometry](https://github.com/miftahul-islam-efaz/brud-code/blob/main/src/components/brand/markGeometry.js): `src/components/brand/markGeometry.js`

### Other components

- **Site visitor**

## Connections

- Site visitor → Home page: visits (evidence: `README.md`)
- Home page → Hero section: renders (evidence: `src/app/page.js`)
- Home page → Scroll journey: wraps hero (evidence: `src/app/page.js`)
- Home page → Install section: renders (evidence: `src/app/page.js`)
- Home page → Feature section: renders (evidence: `src/app/page.js`)
- Home page → Guide section: renders (evidence: `src/app/page.js`)
- Home page → FAQ section: renders (evidence: `src/app/page.js`)
- Home page → Footer section: renders (evidence: `src/app/page.js`)
- Hero section → Hero navigation: renders (evidence: `src/components/hero/Hero.jsx`)
- Hero navigation → Hero content: reads (evidence: `src/components/hero/HeroNav.jsx`)
- Install section → Install content: reads (evidence: `src/components/install/InstallSection.jsx`)
- Feature section → Benchmark chart: renders (evidence: `src/components/features/FeaturesSection.jsx`)
- Guide section → Guide steps: reads (evidence: `src/components/guide/GuideSection.jsx`)
- Guide section → Guide lightbox: opens (evidence: `src/components/guide/GuideSection.jsx`)
- FAQ section → FAQ content: reads (evidence: `src/components/faq/FaqSection.jsx`)
- Footer section → Footer content: reads (evidence: `src/components/footer/FooterSection.jsx`)
- Scroll journey → Brand geometry: uses geometry (evidence: `src/components/journey/Journey.jsx`)
- Shared layout → Smooth anchors: renders (evidence: `src/app/layout.js`)
- Shared layout → Smooth scrolling: renders (evidence: `src/app/layout.js`)
- Shared layout → Scroll reveals: renders (evidence: `src/app/layout.js`)
