# mrtwister99-png/nowowebo architecture

> Architecture diagram of the GitHub repository mrtwister99-png/nowowebo, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mrtwister99-png/nowowebo
- Repository: https://github.com/mrtwister99-png/nowowebo

## Overview

LoYo is a React portfolio and service website for presenting development/design offerings and guiding prospective clients toward an inquiry. Visitors enter through the home page, explore one of four service pages, and can configure a request through an embedded or modal questionnaire. A header mini-game and site-wide visual effects are supporting experiences. The graph reflects the README and available source references; several feature internals were not excerpted, so their uncertain connections are omitted.

Main entry points: [`src/App.tsx`](https://github.com/mrtwister99-png/nowowebo/blob/main/src/App.tsx) (Route and app shell), [`src/features/home/HomeBody.tsx`](https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/home/HomeBody.tsx) (Home page), [`src/features/services/ServicePage.tsx`](https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/services/ServicePage.tsx) (Service page renderer), [`src/features/minigame/useCubesGame.ts`](https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/minigame/useCubesGame.ts) (Game state and timing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["Application shell"]
  node_app["Route and app shell<br/>[App.tsx]"]
  node_routes["Service route map<br/>[routes.ts]"]
  node_navbar["Service navigation<br/>[Navbar.tsx]"]
end

subgraph group_marketing["Portfolio and services"]
  node_home["Home page<br/>[HomeBody.tsx]"]
  node_service_banners["Service banners"]
  node_project_story["Project showcase<br/>[PoProjektu.tsx]"]
  node_consult_banner["Consultation banner"]
  node_services_data["Service content<br/>[servicesData.ts]"]
  node_service_page["Service page renderer<br/>[ServicePage.tsx]"]
  node_service_configs["Service page config<br/>[servicePages.ts]"]
  node_service_extras["Service demos"]
  node_footer["Site footer<br/>[Footer.tsx]"]
end

subgraph group_inquiry["Client inquiries"]
  node_modal_form["Questionnaire modal"]
  node_embedded_form["Service questionnaire"]
  node_inquiry_hub["Inquiry hub"]
  node_quick_message["Quick message"]
end

subgraph group_experience["Interactive experiences"]
  node_header_card["Interactive header<br/>[LoyoHeaderCard.tsx]"]
  node_minigame["Falling-cubes game"]
  node_game_state["Game state and timing<br/>[useCubesGame.ts]"]
  node_game_engine["Game rules engine<br/>[engine.ts]"]
  node_high_scores["High-score state<br/>[useHighScores.ts]"]
  node_board_effects["Board effects<br/>[useBoardEffects.ts]"]
  node_visual_effects["Site visual effects"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens site"| node_app
node_app -->|"resolves service path"| node_routes
node_app -->|"renders on service pages"| node_navbar
node_app -->|"routes home page"| node_home
node_app -->|"routes service page"| node_service_page
node_app -->|"renders questionnaire"| node_modal_form
node_app -->|"renders effects"| node_visual_effects
node_home -->|"renders header"| node_header_card
node_home -->|"renders banners"| node_service_banners
node_home -->|"renders showcase"| node_project_story
node_home -->|"renders banner"| node_consult_banner
node_home -->|"renders footer"| node_footer
node_service_page -.->|"uses service details"| node_services_data
node_service_page -->|"reads page config"| node_service_configs
node_service_page -->|"renders configured extras"| node_service_extras
node_service_page -->|"renders questionnaire"| node_embedded_form
node_header_card -->|"lazy-loads game"| node_minigame
node_header_card -->|"opens questionnaire"| node_modal_form
node_minigame -->|"uses game state"| node_game_state
node_game_state -->|"calls game rules"| node_game_engine
node_game_state -->|"uses score state"| node_high_scores
node_game_state -->|"uses board effects"| node_board_effects
node_embedded_form -->|"uses service options"| node_services_data
node_modal_form -->|"uses service options"| node_services_data

click node_app "https://github.com/mrtwister99-png/nowowebo/blob/main/src/App.tsx"
click node_routes "https://github.com/mrtwister99-png/nowowebo/blob/main/src/data/routes.ts"
click node_navbar "https://github.com/mrtwister99-png/nowowebo/blob/main/src/layout/Navbar.tsx"
click node_home "https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/home/HomeBody.tsx"
click node_service_banners "https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/home/ThreeServiceBanners.tsx"
click node_project_story "https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/home/PoProjektu.tsx"
click node_consult_banner "https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/home/ConsultationSlimBanner.tsx"
click node_services_data "https://github.com/mrtwister99-png/nowowebo/blob/main/src/data/servicesData.ts"
click node_service_page "https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/services/ServicePage.tsx"
click node_service_configs "https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/services/servicePages.ts"
click node_service_extras "https://github.com/mrtwister99-png/nowowebo/tree/main/src/features/services"
click node_footer "https://github.com/mrtwister99-png/nowowebo/blob/main/src/layout/Footer.tsx"
click node_modal_form "https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/inquiry/QuestionnaireModal.tsx"
click node_embedded_form "https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/inquiry/IntegratedQuestionnaire.tsx"
click node_inquiry_hub "https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/inquiry/InquiryHubSection.tsx"
click node_quick_message "https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/inquiry/QuickMessageSection.tsx"
click node_header_card "https://github.com/mrtwister99-png/nowowebo/blob/main/src/layout/LoyoHeaderCard.tsx"
click node_minigame "https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/minigame/MiniFallingCubesInGap.tsx"
click node_game_state "https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/minigame/useCubesGame.ts"
click node_game_engine "https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/minigame/engine.ts"
click node_high_scores "https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/minigame/useHighScores.ts"
click node_board_effects "https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/minigame/useBoardEffects.ts"
click node_visual_effects "https://github.com/mrtwister99-png/nowowebo/tree/main/src/features/effects"

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_app,node_routes,node_navbar toneBlue
class node_home,node_service_banners,node_project_story,node_consult_banner,node_services_data,node_service_page,node_service_configs,node_service_extras,node_footer toneAmber
class node_modal_form,node_embedded_form,node_inquiry_hub,node_quick_message toneMint
class node_header_card,node_minigame,node_game_state,node_game_engine,node_high_scores,node_board_effects,node_visual_effects toneRose
class node_visitor toneIndigo
```

## Components

### Application shell

- [Route and app shell](https://github.com/mrtwister99-png/nowowebo/blob/main/src/App.tsx): `src/App.tsx`
- [Service route map](https://github.com/mrtwister99-png/nowowebo/blob/main/src/data/routes.ts): `src/data/routes.ts`
- [Service navigation](https://github.com/mrtwister99-png/nowowebo/blob/main/src/layout/Navbar.tsx): `src/layout/Navbar.tsx`

### Portfolio and services

- [Home page](https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/home/HomeBody.tsx): `src/features/home/HomeBody.tsx`
- [Service banners](https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/home/ThreeServiceBanners.tsx): `src/features/home/ThreeServiceBanners.tsx`
- [Project showcase](https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/home/PoProjektu.tsx): `src/features/home/PoProjektu.tsx`
- [Consultation banner](https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/home/ConsultationSlimBanner.tsx): `src/features/home/ConsultationSlimBanner.tsx`
- [Service content](https://github.com/mrtwister99-png/nowowebo/blob/main/src/data/servicesData.ts): `src/data/servicesData.ts`
- [Service page renderer](https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/services/ServicePage.tsx): `src/features/services/ServicePage.tsx`
- [Service page config](https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/services/servicePages.ts): `src/features/services/servicePages.ts`
- [Service demos](https://github.com/mrtwister99-png/nowowebo/tree/main/src/features/services): `src/features/services`
- [Site footer](https://github.com/mrtwister99-png/nowowebo/blob/main/src/layout/Footer.tsx): `src/layout/Footer.tsx`

### Client inquiries

- [Questionnaire modal](https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/inquiry/QuestionnaireModal.tsx): `src/features/inquiry/QuestionnaireModal.tsx`
- [Service questionnaire](https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/inquiry/IntegratedQuestionnaire.tsx): `src/features/inquiry/IntegratedQuestionnaire.tsx`
- [Inquiry hub](https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/inquiry/InquiryHubSection.tsx): `src/features/inquiry/InquiryHubSection.tsx`
- [Quick message](https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/inquiry/QuickMessageSection.tsx): `src/features/inquiry/QuickMessageSection.tsx`

### Interactive experiences

- [Interactive header](https://github.com/mrtwister99-png/nowowebo/blob/main/src/layout/LoyoHeaderCard.tsx): `src/layout/LoyoHeaderCard.tsx`
- [Falling-cubes game](https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/minigame/MiniFallingCubesInGap.tsx): `src/features/minigame/MiniFallingCubesInGap.tsx`
- [Game state and timing](https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/minigame/useCubesGame.ts): `src/features/minigame/useCubesGame.ts`
- [Game rules engine](https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/minigame/engine.ts): `src/features/minigame/engine.ts`
- [High-score state](https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/minigame/useHighScores.ts): `src/features/minigame/useHighScores.ts`
- [Board effects](https://github.com/mrtwister99-png/nowowebo/blob/main/src/features/minigame/useBoardEffects.ts): `src/features/minigame/useBoardEffects.ts`
- [Site visual effects](https://github.com/mrtwister99-png/nowowebo/tree/main/src/features/effects): `src/features/effects`

### Other components

- **Visitor**

## Connections

- Visitor → Route and app shell: opens site
- Route and app shell → Service route map: resolves service path (evidence: `src/App.tsx`)
- Route and app shell → Service navigation: renders on service pages (evidence: `src/App.tsx`)
- Route and app shell → Home page: routes home page (evidence: `src/App.tsx`)
- Route and app shell → Service page renderer: routes service page (evidence: `src/App.tsx`)
- Route and app shell → Questionnaire modal: renders questionnaire (evidence: `src/App.tsx`)
- Route and app shell → Site visual effects: renders effects (evidence: `src/App.tsx`)
- Home page → Interactive header: renders header (evidence: `src/features/home/HomeBody.tsx`)
- Home page → Service banners: renders banners (evidence: `src/features/home/HomeBody.tsx`)
- Home page → Project showcase: renders showcase (evidence: `src/features/home/HomeBody.tsx`)
- Home page → Consultation banner: renders banner (evidence: `src/features/home/HomeBody.tsx`)
- Home page → Site footer: renders footer (evidence: `src/features/home/HomeBody.tsx`)
- Service page renderer → Service content: uses service details
- Service page renderer → Service page config: reads page config (evidence: `src/features/services/ServicePage.tsx`)
- Service page renderer → Service demos: renders configured extras (evidence: `src/features/services/ServicePage.tsx`)
- Service page renderer → Service questionnaire: renders questionnaire (evidence: `src/features/services/ServicePage.tsx`)
- Interactive header → Falling-cubes game: lazy-loads game (evidence: `src/layout/LoyoHeaderCard.tsx`)
- Interactive header → Questionnaire modal: opens questionnaire (evidence: `src/layout/LoyoHeaderCard.tsx`)
- Falling-cubes game → Game state and timing: uses game state (evidence: `src/features/minigame/MiniFallingCubesInGap.tsx`)
- Game state and timing → Game rules engine: calls game rules (evidence: `src/features/minigame/useCubesGame.ts`)
- Game state and timing → High-score state: uses score state (evidence: `src/features/minigame/useCubesGame.ts`)
- Game state and timing → Board effects: uses board effects (evidence: `src/features/minigame/useCubesGame.ts`)
- Service questionnaire → Service content: uses service options (evidence: `src/features/inquiry/IntegratedQuestionnaire.tsx`)
- Questionnaire modal → Service content: uses service options (evidence: `src/features/inquiry/QuestionnaireModal.tsx`)
