# vladward/pokemon architecture

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

- Interactive diagram: https://gitdiagram.com/vladward/pokemon
- Repository: https://github.com/vladward/pokemon

## Overview

PokeWiki is a client-side Pokémon portal whose visible product is a modular home page, surrounded by responsive navigation and a persistent theme control. The runtime entry renders App; App wraps Home in the theme provider and shared layout. The home page presents abilities, elements, evolution, and Pokémon League content. Supporting layers include theme state, responsive breakpoints, and reusable UI. Relationships are grounded in the supplied source index and excerpts or documented in the README; unsampled section internals and data wiring are not inferred.

Main entry points: [`src/pages/Home/Home.tsx`](https://github.com/vladward/pokemon/blob/main/src/pages/Home/Home.tsx) (Home Page), [`src/widgets/Header/ui/Header/Header.tsx`](https://github.com/vladward/pokemon/blob/main/src/widgets/Header/ui/Header/Header.tsx) (Header), [`src/app/App.tsx`](https://github.com/vladward/pokemon/blob/main/src/app/App.tsx) (App), [`src/widgets/Layout/ui/Layout.tsx`](https://github.com/vladward/pokemon/blob/main/src/widgets/Layout/ui/Layout.tsx) (Layout)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_application["Application Shell"]
  node_entry["React Entry<br/>[index.tsx]"]
  node_app["App<br/>[App.tsx]"]
  node_theme_provider["Theme Provider<br/>[ThemeProvider.tsx]"]
  node_layout["Layout<br/>[Layout.tsx]"]
end

subgraph group_home["Home Content"]
  node_home_page["Home Page<br/>[Home.tsx]"]
  node_abilities["Abilities"]
  node_elements["Elements"]
  node_evolution["Evolution"]
  node_league["Pokémon League<br/>[LeagueSection.tsx]"]
  node_element_data["Element Data<br/>[elementsData.tsx]"]
end

subgraph group_navigation["Navigation"]
  node_header["Header<br/>[Header.tsx]"]
  node_mobile_nav["Mobile Navigation"]
  node_nav_links["Navigation Links<br/>[NavLinks.tsx]"]
  node_footer["Footer<br/>[Footer.tsx]"]
  node_theme_switcher["Theme Switcher<br/>[ThemeSwitcher.tsx]"]
end

subgraph group_shared["Shared Runtime"]
  node_theme_hook["Theme Hook<br/>[useTheme.ts]"]
  node_theme_context["Theme Context<br/>[ThemeContext.ts]"]
  node_breakpoints["Breakpoint Hook<br/>[useBreakpoints.ts]"]
  node_slider["Infinite Slider<br/>[InfiniteSlider.tsx]"]
  node_ui_primitives["UI Primitives"]
end

node_browser(("Browser"))

node_browser -.->|"loads app"| node_entry
node_entry -->|"renders"| node_app
node_app -->|"wraps in"| node_theme_provider
node_app -->|"wraps in"| node_layout
node_app -->|"renders"| node_home_page
node_home_page -->|"includes"| node_abilities
node_home_page -->|"includes"| node_elements
node_home_page -->|"includes"| node_evolution
node_home_page -->|"includes"| node_league
node_home_page -.->|"uses"| node_element_data
node_layout -->|"renders"| node_header
node_layout -->|"renders"| node_footer
node_header -->|"renders"| node_mobile_nav
node_header -->|"renders"| node_nav_links
node_header -->|"renders"| node_theme_switcher
node_footer -->|"renders"| node_nav_links
node_footer -->|"reads"| node_breakpoints
node_header -->|"reads"| node_breakpoints
node_theme_switcher -->|"toggles via"| node_theme_hook
node_theme_hook -->|"reads"| node_theme_context
node_theme_provider -->|"configures"| node_theme_context
node_home_page -.->|"uses"| node_ui_primitives
node_elements -->|"uses"| node_ui_primitives
node_slider -.->|"exports through"| node_ui_primitives

click node_entry "https://github.com/vladward/pokemon/blob/main/src/index.tsx"
click node_app "https://github.com/vladward/pokemon/blob/main/src/app/App.tsx"
click node_theme_provider "https://github.com/vladward/pokemon/blob/main/src/app/providers/ThemeProvider/ThemeProvider.tsx"
click node_layout "https://github.com/vladward/pokemon/blob/main/src/widgets/Layout/ui/Layout.tsx"
click node_home_page "https://github.com/vladward/pokemon/blob/main/src/pages/Home/Home.tsx"
click node_abilities "https://github.com/vladward/pokemon/blob/main/src/pages/Home/ui/AbilitiesSection/AbilitiesSection.tsx"
click node_elements "https://github.com/vladward/pokemon/blob/main/src/pages/Home/ui/ElementsSection/ElementsPreview.tsx"
click node_evolution "https://github.com/vladward/pokemon/blob/main/src/pages/Home/ui/EvolutionSection/EvolutionSection.tsx"
click node_league "https://github.com/vladward/pokemon/blob/main/src/pages/Home/ui/LeagueSection/LeagueSection.tsx"
click node_element_data "https://github.com/vladward/pokemon/blob/main/src/pages/Home/model/elementsData.tsx"
click node_header "https://github.com/vladward/pokemon/blob/main/src/widgets/Header/ui/Header/Header.tsx"
click node_mobile_nav "https://github.com/vladward/pokemon/blob/main/src/widgets/Header/ui/MobileNavigation/MobileNavigation.tsx"
click node_nav_links "https://github.com/vladward/pokemon/blob/main/src/entities/NavLinks/NavLinks.tsx"
click node_footer "https://github.com/vladward/pokemon/blob/main/src/widgets/Footer/ui/Footer.tsx"
click node_theme_switcher "https://github.com/vladward/pokemon/blob/main/src/features/ThemeSwitcher/ThemeSwitcher.tsx"
click node_theme_hook "https://github.com/vladward/pokemon/blob/main/src/shared/lib/theme/useTheme.ts"
click node_theme_context "https://github.com/vladward/pokemon/blob/main/src/shared/lib/theme/ThemeContext.ts"
click node_breakpoints "https://github.com/vladward/pokemon/blob/main/src/shared/lib/hooks/useBreakpoints.ts"
click node_slider "https://github.com/vladward/pokemon/blob/main/src/shared/ui/InfiniteSlider/InfiniteSlider.tsx"
click node_ui_primitives "https://github.com/vladward/pokemon/tree/main/src/shared/ui"

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_entry,node_app,node_theme_provider,node_layout,node_browser toneBlue
class node_home_page,node_abilities,node_elements,node_evolution,node_league,node_element_data toneAmber
class node_header,node_mobile_nav,node_nav_links,node_footer,node_theme_switcher toneMint
class node_theme_hook,node_theme_context,node_breakpoints,node_slider,node_ui_primitives toneRose
```

## Components

### Application Shell

- [React Entry](https://github.com/vladward/pokemon/blob/main/src/index.tsx): `src/index.tsx`
- [App](https://github.com/vladward/pokemon/blob/main/src/app/App.tsx): `src/app/App.tsx`
- [Theme Provider](https://github.com/vladward/pokemon/blob/main/src/app/providers/ThemeProvider/ThemeProvider.tsx): `src/app/providers/ThemeProvider/ThemeProvider.tsx`
- [Layout](https://github.com/vladward/pokemon/blob/main/src/widgets/Layout/ui/Layout.tsx): `src/widgets/Layout/ui/Layout.tsx`

### Home Content

- [Home Page](https://github.com/vladward/pokemon/blob/main/src/pages/Home/Home.tsx): `src/pages/Home/Home.tsx`
- [Abilities](https://github.com/vladward/pokemon/blob/main/src/pages/Home/ui/AbilitiesSection/AbilitiesSection.tsx): `src/pages/Home/ui/AbilitiesSection/AbilitiesSection.tsx`
- [Elements](https://github.com/vladward/pokemon/blob/main/src/pages/Home/ui/ElementsSection/ElementsPreview.tsx): `src/pages/Home/ui/ElementsSection/ElementsPreview.tsx`
- [Evolution](https://github.com/vladward/pokemon/blob/main/src/pages/Home/ui/EvolutionSection/EvolutionSection.tsx): `src/pages/Home/ui/EvolutionSection/EvolutionSection.tsx`
- [Pokémon League](https://github.com/vladward/pokemon/blob/main/src/pages/Home/ui/LeagueSection/LeagueSection.tsx): `src/pages/Home/ui/LeagueSection/LeagueSection.tsx`
- [Element Data](https://github.com/vladward/pokemon/blob/main/src/pages/Home/model/elementsData.tsx): `src/pages/Home/model/elementsData.tsx`

### Navigation

- [Header](https://github.com/vladward/pokemon/blob/main/src/widgets/Header/ui/Header/Header.tsx): `src/widgets/Header/ui/Header/Header.tsx`
- [Mobile Navigation](https://github.com/vladward/pokemon/blob/main/src/widgets/Header/ui/MobileNavigation/MobileNavigation.tsx): `src/widgets/Header/ui/MobileNavigation/MobileNavigation.tsx`
- [Navigation Links](https://github.com/vladward/pokemon/blob/main/src/entities/NavLinks/NavLinks.tsx): `src/entities/NavLinks/NavLinks.tsx`
- [Footer](https://github.com/vladward/pokemon/blob/main/src/widgets/Footer/ui/Footer.tsx): `src/widgets/Footer/ui/Footer.tsx`
- [Theme Switcher](https://github.com/vladward/pokemon/blob/main/src/features/ThemeSwitcher/ThemeSwitcher.tsx): `src/features/ThemeSwitcher/ThemeSwitcher.tsx`

### Shared Runtime

- [Theme Hook](https://github.com/vladward/pokemon/blob/main/src/shared/lib/theme/useTheme.ts): `src/shared/lib/theme/useTheme.ts`
- [Theme Context](https://github.com/vladward/pokemon/blob/main/src/shared/lib/theme/ThemeContext.ts): `src/shared/lib/theme/ThemeContext.ts`
- [Breakpoint Hook](https://github.com/vladward/pokemon/blob/main/src/shared/lib/hooks/useBreakpoints.ts): `src/shared/lib/hooks/useBreakpoints.ts`
- [Infinite Slider](https://github.com/vladward/pokemon/blob/main/src/shared/ui/InfiniteSlider/InfiniteSlider.tsx): `src/shared/ui/InfiniteSlider/InfiniteSlider.tsx`
- [UI Primitives](https://github.com/vladward/pokemon/tree/main/src/shared/ui): `src/shared/ui`

### Other components

- **Browser**

## Connections

- Browser → React Entry: loads app
- React Entry → App: renders (evidence: `src/index.tsx`)
- App → Theme Provider: wraps in (evidence: `src/app/App.tsx`)
- App → Layout: wraps in (evidence: `src/app/App.tsx`)
- App → Home Page: renders (evidence: `src/app/App.tsx`)
- Home Page → Abilities: includes (evidence: `README.md`)
- Home Page → Elements: includes (evidence: `README.md`)
- Home Page → Evolution: includes (evidence: `README.md`)
- Home Page → Pokémon League: includes (evidence: `README.md`)
- Home Page → Element Data: uses
- Layout → Header: renders (evidence: `src/widgets/Layout/ui/Layout.tsx`)
- Layout → Footer: renders (evidence: `src/widgets/Layout/ui/Layout.tsx`)
- Header → Mobile Navigation: renders (evidence: `src/widgets/Header/ui/Header/Header.tsx`)
- Header → Navigation Links: renders (evidence: `src/widgets/Header/index.ts`)
- Header → Theme Switcher: renders (evidence: `src/widgets/Header/ui/Header/Header.tsx`)
- Footer → Navigation Links: renders (evidence: `src/widgets/Footer/ui/Footer.tsx`)
- Footer → Breakpoint Hook: reads (evidence: `src/widgets/Footer/ui/Footer.tsx`)
- Header → Breakpoint Hook: reads (evidence: `src/widgets/Header/ui/Header/Header.tsx`)
- Theme Switcher → Theme Hook: toggles via (evidence: `src/features/ThemeSwitcher/ThemeSwitcher.tsx`)
- Theme Hook → Theme Context: reads (evidence: `src/shared/lib/theme/useTheme.ts`)
- Theme Provider → Theme Context: configures (evidence: `src/app/providers/ThemeProvider/ThemeProvider.tsx`)
- Home Page → UI Primitives: uses
- Elements → UI Primitives: uses (evidence: `src/pages/Home/ui/ElementsSection/ElementsPreview.tsx`)
- Infinite Slider → UI Primitives: exports through (evidence: `src/shared/ui/InfiniteSlider/InfiniteSlider.tsx`)
