# david-fernando/medium-posts-card architecture

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

- Interactive diagram: https://gitdiagram.com/david-fernando/medium-posts-card
- Repository: https://github.com/david-fernando/medium-posts-card

## Overview

Medium Posts Card is a React library for fetching Medium articles and displaying them as a carousel or list, with optional server-side prefetched data. The principal workflow is username → article retrieval → component rendering; callers can instead prefetch with fetchMedium and pass the result with SSR enabled. The README also documents Label as a wrapper for either display. Edges reflect the README and source-index references plus the shown excerpts; unsampled implementation details are not inferred.

Main entry points: [`src/components/Carousel.tsx`](https://github.com/david-fernando/medium-posts-card/blob/main/src/components/Carousel.tsx) (Carousel), [`src/components/List.tsx`](https://github.com/david-fernando/medium-posts-card/blob/main/src/components/List.tsx) (Article List), [`src/index.tsx`](https://github.com/david-fernando/medium-posts-card/blob/main/src/index.tsx) (Library Exports), [`src/components/Label.tsx`](https://github.com/david-fernando/medium-posts-card/blob/main/src/components/Label.tsx) (Label Wrapper)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public_api["Public API"]
  node_library_entry["Library Exports<br/>[index.tsx]"]
  node_shared_types["Component Props<br/>[interface.ts]"]
end

subgraph group_retrieval["Article Retrieval"]
  node_fetch_medium["Fetch Articles<br/>[fetchMedium.ts]"]
  node_medium_hook["Load Articles<br/>[useGetMedium.tsx]"]
end

subgraph group_displays["Article Displays"]
  node_carousel["Carousel<br/>[Carousel.tsx]"]
  node_list["Article List<br/>[List.tsx]"]
  node_label["Label Wrapper<br/>[Label.tsx]"]
  node_card["Carousel Card<br/>[Card.tsx]"]
  node_rectangular_card["List Card"]
end

subgraph group_rendering["Rendering Support"]
  node_carousel_state["Carousel Movement<br/>[useCarousel.tsx]"]
  node_visibility["Card Visibility<br/>[useIsVisible.tsx]"]
  node_last_card["Last Card Ref<br/>[useLastCard.tsx]"]
  node_array_helper["Array Check<br/>[useArray.tsx]"]
  node_tag_spacing["Tag Formatting<br/>[useBlankSpace.tsx]"]
end

node_site_author(("Site Author"))
node_medium_service["Medium Posts API"]

node_site_author -->|"uses components"| node_library_entry
node_site_author -->|"prefetches articles"| node_fetch_medium
node_library_entry -->|"exports"| node_carousel
node_library_entry -->|"exports"| node_list
node_library_entry -->|"exports"| node_label
node_library_entry -->|"exports"| node_fetch_medium
node_carousel -->|"uses props"| node_shared_types
node_list -->|"uses props"| node_shared_types
node_label -->|"uses props"| node_shared_types
node_carousel -->|"loads articles"| node_medium_hook
node_list -->|"loads articles"| node_medium_hook
node_medium_hook -->|"fetches articles"| node_fetch_medium
node_fetch_medium -->|"requests articles"| node_medium_service
node_carousel -->|"renders cards"| node_card
node_list -->|"renders cards"| node_rectangular_card
node_label -->|"wraps component"| node_carousel
node_label -->|"wraps component"| node_list
node_carousel -->|"moves position"| node_carousel_state
node_carousel -->|"checks visibility"| node_visibility
node_carousel -->|"sets last ref"| node_last_card
node_card -->|"checks tags"| node_array_helper
node_card -->|"formats tags"| node_tag_spacing
node_rectangular_card -->|"checks tags"| node_array_helper
node_rectangular_card -->|"formats tags"| node_tag_spacing
node_medium_hook -->|"checks data"| node_array_helper
node_site_author -->|"supplies prefetched data"| node_carousel
node_site_author -->|"supplies prefetched data"| node_list

click node_library_entry "https://github.com/david-fernando/medium-posts-card/blob/main/src/index.tsx"
click node_shared_types "https://github.com/david-fernando/medium-posts-card/blob/main/src/interface/interface.ts"
click node_fetch_medium "https://github.com/david-fernando/medium-posts-card/blob/main/src/utils/fetchMedium.ts"
click node_medium_hook "https://github.com/david-fernando/medium-posts-card/blob/main/src/hooks/useGetMedium.tsx"
click node_carousel "https://github.com/david-fernando/medium-posts-card/blob/main/src/components/Carousel.tsx"
click node_list "https://github.com/david-fernando/medium-posts-card/blob/main/src/components/List.tsx"
click node_label "https://github.com/david-fernando/medium-posts-card/blob/main/src/components/Label.tsx"
click node_card "https://github.com/david-fernando/medium-posts-card/blob/main/src/components/Card.tsx"
click node_rectangular_card "https://github.com/david-fernando/medium-posts-card/blob/main/src/components/RectangularCard.tsx"
click node_carousel_state "https://github.com/david-fernando/medium-posts-card/blob/main/src/hooks/useCarousel.tsx"
click node_visibility "https://github.com/david-fernando/medium-posts-card/blob/main/src/hooks/useIsVisible.tsx"
click node_last_card "https://github.com/david-fernando/medium-posts-card/blob/main/src/hooks/useLastCard.tsx"
click node_array_helper "https://github.com/david-fernando/medium-posts-card/blob/main/src/hooks/useArray.tsx"
click node_tag_spacing "https://github.com/david-fernando/medium-posts-card/blob/main/src/hooks/useBlankSpace.tsx"

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_library_entry,node_shared_types toneBlue
class node_fetch_medium,node_medium_hook toneAmber
class node_carousel,node_list,node_label,node_card,node_rectangular_card,node_medium_service toneMint
class node_carousel_state,node_visibility,node_last_card,node_array_helper,node_tag_spacing toneRose
class node_site_author toneIndigo
```

## Components

### Public API

- [Library Exports](https://github.com/david-fernando/medium-posts-card/blob/main/src/index.tsx): `src/index.tsx`
- [Component Props](https://github.com/david-fernando/medium-posts-card/blob/main/src/interface/interface.ts): `src/interface/interface.ts`

### Article Retrieval

- [Fetch Articles](https://github.com/david-fernando/medium-posts-card/blob/main/src/utils/fetchMedium.ts): `src/utils/fetchMedium.ts`
- [Load Articles](https://github.com/david-fernando/medium-posts-card/blob/main/src/hooks/useGetMedium.tsx): `src/hooks/useGetMedium.tsx`

### Article Displays

- [Carousel](https://github.com/david-fernando/medium-posts-card/blob/main/src/components/Carousel.tsx): `src/components/Carousel.tsx`
- [Article List](https://github.com/david-fernando/medium-posts-card/blob/main/src/components/List.tsx): `src/components/List.tsx`
- [Label Wrapper](https://github.com/david-fernando/medium-posts-card/blob/main/src/components/Label.tsx): `src/components/Label.tsx`
- [Carousel Card](https://github.com/david-fernando/medium-posts-card/blob/main/src/components/Card.tsx): `src/components/Card.tsx`
- [List Card](https://github.com/david-fernando/medium-posts-card/blob/main/src/components/RectangularCard.tsx): `src/components/RectangularCard.tsx`

### Rendering Support

- [Carousel Movement](https://github.com/david-fernando/medium-posts-card/blob/main/src/hooks/useCarousel.tsx): `src/hooks/useCarousel.tsx`
- [Card Visibility](https://github.com/david-fernando/medium-posts-card/blob/main/src/hooks/useIsVisible.tsx): `src/hooks/useIsVisible.tsx`
- [Last Card Ref](https://github.com/david-fernando/medium-posts-card/blob/main/src/hooks/useLastCard.tsx): `src/hooks/useLastCard.tsx`
- [Array Check](https://github.com/david-fernando/medium-posts-card/blob/main/src/hooks/useArray.tsx): `src/hooks/useArray.tsx`
- [Tag Formatting](https://github.com/david-fernando/medium-posts-card/blob/main/src/hooks/useBlankSpace.tsx): `src/hooks/useBlankSpace.tsx`

### Other components

- **Site Author**
- **Medium Posts API**

## Connections

- Site Author → Library Exports: uses components (evidence: `README.md`)
- Site Author → Fetch Articles: prefetches articles (evidence: `README.md`)
- Library Exports → Carousel: exports (evidence: `src/index.tsx`)
- Library Exports → Article List: exports (evidence: `src/index.tsx`)
- Library Exports → Label Wrapper: exports (evidence: `src/index.tsx`)
- Library Exports → Fetch Articles: exports (evidence: `src/index.tsx`)
- Carousel → Component Props: uses props (evidence: `src/components/Carousel.tsx`)
- Article List → Component Props: uses props (evidence: `src/components/List.tsx`)
- Label Wrapper → Component Props: uses props (evidence: `src/components/Label.tsx`)
- Carousel → Load Articles: loads articles (evidence: `src/components/Carousel.tsx`)
- Article List → Load Articles: loads articles (evidence: `src/components/List.tsx`)
- Load Articles → Fetch Articles: fetches articles (evidence: `src/hooks/useGetMedium.tsx`)
- Fetch Articles → Medium Posts API: requests articles (evidence: `src/utils/fetchMedium.ts`)
- Carousel → Carousel Card: renders cards (evidence: `src/components/Carousel.tsx`)
- Article List → List Card: renders cards (evidence: `src/components/List.tsx`)
- Label Wrapper → Carousel: wraps component (evidence: `README.md`)
- Label Wrapper → Article List: wraps component (evidence: `README.md`)
- Carousel → Carousel Movement: moves position (evidence: `src/components/Carousel.tsx`)
- Carousel → Card Visibility: checks visibility (evidence: `src/components/Carousel.tsx`)
- Carousel → Last Card Ref: sets last ref (evidence: `src/components/Carousel.tsx`)
- Carousel Card → Array Check: checks tags (evidence: `src/components/Card.tsx`)
- Carousel Card → Tag Formatting: formats tags (evidence: `src/components/Card.tsx`)
- List Card → Array Check: checks tags (evidence: `src/components/RectangularCard.tsx`)
- List Card → Tag Formatting: formats tags (evidence: `src/components/RectangularCard.tsx`)
- Load Articles → Array Check: checks data (evidence: `src/hooks/useGetMedium.tsx`)
- Site Author → Carousel: supplies prefetched data (evidence: `README.md`)
- Site Author → Article List: supplies prefetched data (evidence: `README.md`)
