flowchart LR
  %% Modules and dependencies (key subset)
  classDef svc fill:#0b273f,stroke:#3a72a0,color:#e8eaf0;
  classDef util fill:#2b2f3f,stroke:#6a7aa0,color:#e8eaf0;
  classDef ctx fill:#2b233f,stroke:#7a63a0,color:#e8eaf0;
  classDef hook fill:#2a2a1f,stroke:#9a8a3d,color:#e8eaf0;
  classDef page fill:#1c243a,stroke:#4b5b8a,color:#e8eaf0;

  subgraph Contexts
    AuthContext[contexts/AuthContext]:::ctx
    ClubThemeContext[contexts/ClubThemeContext]:::ctx
  end

  subgraph Hooks
    usePublicSettings[hooks/usePublicSettings]:::hook
    usePageElementConfig[hooks/usePageElementConfig]:::hook
    useAllPageElementConfigs[hooks/usePageElementConfig.useAll]:::hook
    useUmami[hooks/useUmami]:::hook
    useFontLoader[hooks/useFontLoader]:::hook
  end

  subgraph Services
    apiCore[services/api]:::svc
    errorReporter[services/errorReporter]:::svc
    settingsSvc[services/settings]:::svc
    pageElementsSvc[services/pageElements]:::svc
    articlesSvc[services/articles]:::svc
    playersSvc[services/players]:::svc
    sponsorsSvc[services/sponsors]:::svc
    bannersSvc[services/banners]:::svc
    compAliasesSvc[services/competitionAliases]:::svc
    eventsSvc[services/eventService]:::svc
    setupSvc[services/setup]:::svc
    engagementSvc[services/engagement]:::svc
    actionLogSvc[services/actionLog]:::svc
    facrApi[services/facr/facrApi]:::svc
  end

  subgraph Utils
    urlUtil[utils/url]:::util
    nationalityUtil[utils/nationality]:::util
    colorsUtil[utils/colors]:::util
    logosUtil[utils/sportLogosAPI]:::util
  end

  subgraph Pages
    HomePage:::page
    BlogPage:::page
    ArticleDetailPage:::page
    MatchDetailPage:::page
    ActivityDetailPage:::page
    AdminPages[(Admin Pages...)]:::page
  end

  HomePage --> settingsSvc
  HomePage --> pageElementsSvc
  HomePage --> articlesSvc
  HomePage --> playersSvc
  HomePage --> sponsorsSvc
  HomePage --> bannersSvc
  HomePage --> compAliasesSvc
  HomePage --> eventsSvc
  HomePage --> facrApi

  Pages --> apiCore
  Pages --> errorReporter
  Pages --> usePublicSettings
  Pages --> usePageElementConfig
  Pages --> useUmami
  Pages --> useFontLoader
  Pages --> urlUtil
  Pages --> nationalityUtil

  ClubThemeContext --> usePublicSettings
  ClubThemeContext --> facrApi
  ClubThemeContext --> colorsUtil
  ClubThemeContext --> logosUtil

  errorReporter -. sends .- ErrorIngest[(errors.tdvorak.dev)]
  apiCore -. REST .- Backend[(fotbal-club backend)]
  facrApi -. data .- FACR[(FACR APIs)]