# gothinkster/react-redux-realworld-example-app architecture

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

- Interactive diagram: https://gitdiagram.com/gothinkster/react-redux-realworld-example-app
- Repository: https://github.com/gothinkster/react-redux-realworld-example-app

## Overview

Conduit is a React/Redux social-blogging frontend. Users authenticate, browse filtered or paginated feeds, read and interact with articles, publish or edit posts, and manage profiles and settings. The routed App is the entry point; feature views dispatch actions and request data through the API agent, while Redux middleware resolves asynchronous actions and reducers maintain view state. README-described capabilities are included even where their implementation was not excerpted; edges for those paths are limited to documented relationships.

Main entry points: [`src/components/App.js`](https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/components/App.js) (App router), [`src/agent.js`](https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/agent.js) (API agent), [`src/reducer.js`](https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/reducer.js) (Root reducer), [`src/components/Home/MainView.js`](https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/components/Home/MainView.js) (Home feed)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_routing["Routing and shell"]
  node_app["App router<br/>[App.js]"]
  node_header["Navigation header<br/>[Header.js]"]
end

subgraph group_discovery["Feed and profiles"]
  node_home["Home feed<br/>[MainView.js]"]
  node_articlelist["Article lists<br/>[ArticleList.js]"]
  node_preview["Article preview<br/>[ArticlePreview.js]"]
  node_tags["Tag discovery<br/>[Tags.js]"]
  node_profile["User profiles<br/>[Profile.js]"]
  node_favoritesprofile["Favorited articles"]
end

subgraph group_publishing["Articles and comments"]
  node_article["Article reader<br/>[index.js]"]
  node_editor["Article editor<br/>[Editor.js]"]
  node_comments["Comment controls<br/>[CommentInput.js]"]
  node_commentview["Comment display"]
end

subgraph group_identity["Identity and settings"]
  node_login["Sign in<br/>[Login.js]"]
  node_register["Sign up<br/>[Register.js]"]
  node_settings["Account settings<br/>[Settings.js]"]
end

subgraph group_runtime["API and Redux state"]
  node_api["API agent<br/>[agent.js]"]
  node_store[("Redux store<br/>[store.js]")]
  node_middleware["Async middleware<br/>[middleware.js]"]
  node_rootreducer["Root reducer<br/>[reducer.js]"]
  node_liststate["Feed state<br/>[articleList.js]"]
  node_commonstate["Session state<br/>[common.js]"]
  node_articlestate["Article state<br/>[article.js]"]
  node_editorstate["Editor state<br/>[editor.js]"]
  node_authstate["Auth state<br/>[auth.js]"]
end

node_reader(("Visitor"))
node_backend{{"Conduit API"}}

node_reader -->|"opens app"| node_app
node_app -->|"renders"| node_header
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_article
node_app -->|"routes to"| node_editor
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_register
node_app -->|"routes to"| node_profile
node_app -->|"routes to"| node_favoritesprofile
node_app -->|"routes to"| node_settings
node_home -->|"renders"| node_articlelist
node_articlelist -->|"renders"| node_preview
node_home -->|"requests feed"| node_api
node_home -.->|"shows tags"| node_tags
node_preview -->|"favorites article"| node_api
node_profile -->|"loads profile"| node_api
node_favoritesprofile -->|"reuses profile"| node_profile
node_article -->|"loads article"| node_api
node_article -->|"renders comments"| node_commentview
node_comments -->|"posts comment"| node_api
node_editor -->|"saves article"| node_api
node_login -->|"authenticates"| node_api
node_register -->|"creates account"| node_api
node_settings -->|"updates account"| node_api
node_api -->|"sends API requests"| node_backend
node_app -->|"dispatches actions"| node_store
node_store -->|"applies middleware"| node_middleware
node_store -->|"uses reducer"| node_rootreducer
node_rootreducer -->|"combines"| node_liststate
node_rootreducer -->|"combines"| node_commonstate
node_rootreducer -->|"combines"| node_articlestate
node_rootreducer -->|"combines"| node_editorstate
node_rootreducer -->|"combines"| node_authstate
node_middleware -->|"sets auth token"| node_api
node_api -.->|"returns responses"| node_store

click node_app "https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/components/App.js"
click node_header "https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/components/Header.js"
click node_home "https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/components/Home/MainView.js"
click node_articlelist "https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/components/ArticleList.js"
click node_preview "https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/components/ArticlePreview.js"
click node_tags "https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/components/Home/Tags.js"
click node_profile "https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/components/Profile.js"
click node_favoritesprofile "https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/components/ProfileFavorites.js"
click node_article "https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/components/Article/index.js"
click node_editor "https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/components/Editor.js"
click node_comments "https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/components/Article/CommentInput.js"
click node_commentview "https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/components/Article/CommentContainer.js"
click node_login "https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/components/Login.js"
click node_register "https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/components/Register.js"
click node_settings "https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/components/Settings.js"
click node_api "https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/agent.js"
click node_store "https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/store.js"
click node_middleware "https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/middleware.js"
click node_rootreducer "https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/reducer.js"
click node_liststate "https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/reducers/articleList.js"
click node_commonstate "https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/reducers/common.js"
click node_articlestate "https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/reducers/article.js"
click node_editorstate "https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/reducers/editor.js"
click node_authstate "https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/reducers/auth.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_app,node_header toneBlue
class node_home,node_articlelist,node_preview,node_tags,node_profile,node_favoritesprofile toneAmber
class node_article,node_editor,node_comments,node_commentview,node_backend toneMint
class node_login,node_register,node_settings toneRose
class node_api,node_store,node_middleware,node_rootreducer,node_liststate,node_commonstate,node_articlestate,node_editorstate,node_authstate,node_reader toneIndigo
```

## Components

### Routing and shell

- [App router](https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/components/App.js): `src/components/App.js`
- [Navigation header](https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/components/Header.js): `src/components/Header.js`

### Feed and profiles

- [Home feed](https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/components/Home/MainView.js): `src/components/Home/MainView.js`
- [Article lists](https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/components/ArticleList.js): `src/components/ArticleList.js`
- [Article preview](https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/components/ArticlePreview.js): `src/components/ArticlePreview.js`
- [Tag discovery](https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/components/Home/Tags.js): `src/components/Home/Tags.js`
- [User profiles](https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/components/Profile.js): `src/components/Profile.js`
- [Favorited articles](https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/components/ProfileFavorites.js): `src/components/ProfileFavorites.js`

### Articles and comments

- [Article reader](https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/components/Article/index.js): `src/components/Article/index.js`
- [Article editor](https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/components/Editor.js): `src/components/Editor.js`
- [Comment controls](https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/components/Article/CommentInput.js): `src/components/Article/CommentInput.js`
- [Comment display](https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/components/Article/CommentContainer.js): `src/components/Article/CommentContainer.js`

### Identity and settings

- [Sign in](https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/components/Login.js): `src/components/Login.js`
- [Sign up](https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/components/Register.js): `src/components/Register.js`
- [Account settings](https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/components/Settings.js): `src/components/Settings.js`

### API and Redux state

- [API agent](https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/agent.js): `src/agent.js`
- [Redux store](https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/store.js): `src/store.js`
- [Async middleware](https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/middleware.js): `src/middleware.js`
- [Root reducer](https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/reducer.js): `src/reducer.js`
- [Feed state](https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/reducers/articleList.js): `src/reducers/articleList.js`
- [Session state](https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/reducers/common.js): `src/reducers/common.js`
- [Article state](https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/reducers/article.js): `src/reducers/article.js`
- [Editor state](https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/reducers/editor.js): `src/reducers/editor.js`
- [Auth state](https://github.com/gothinkster/react-redux-realworld-example-app/blob/master/src/reducers/auth.js): `src/reducers/auth.js`

### Other components

- **Visitor**
- **Conduit API**

## Connections

- Visitor → App router: opens app (evidence: `src/components/App.js`)
- App router → Navigation header: renders (evidence: `src/components/App.js`)
- App router → Home feed: routes to (evidence: `src/components/App.js`)
- App router → Article reader: routes to (evidence: `src/components/App.js`)
- App router → Article editor: routes to (evidence: `src/components/App.js`)
- App router → Sign in: routes to (evidence: `src/components/App.js`)
- App router → Sign up: routes to (evidence: `src/components/App.js`)
- App router → User profiles: routes to (evidence: `src/components/App.js`)
- App router → Favorited articles: routes to (evidence: `src/components/App.js`)
- App router → Account settings: routes to (evidence: `src/components/App.js`)
- Home feed → Article lists: renders (evidence: `src/components/Home/MainView.js`)
- Article lists → Article preview: renders (evidence: `src/components/ArticleList.js`)
- Home feed → API agent: requests feed (evidence: `src/components/Home/MainView.js`)
- Home feed → Tag discovery: shows tags
- Article preview → API agent: favorites article (evidence: `src/components/ArticlePreview.js`)
- User profiles → API agent: loads profile (evidence: `src/components/Profile.js`)
- Favorited articles → User profiles: reuses profile (evidence: `src/components/ProfileFavorites.js`)
- Article reader → API agent: loads article (evidence: `src/components/Article/index.js`)
- Article reader → Comment display: renders comments (evidence: `src/components/Article/index.js`)
- Comment controls → API agent: posts comment (evidence: `src/components/Article/CommentInput.js`)
- Article editor → API agent: saves article (evidence: `src/components/Editor.js`)
- Sign in → API agent: authenticates (evidence: `src/components/Login.js`)
- Sign up → API agent: creates account (evidence: `src/components/Register.js`)
- Account settings → API agent: updates account (evidence: `src/components/Settings.js`)
- API agent → Conduit API: sends API requests (evidence: `src/agent.js`)
- App router → Redux store: dispatches actions (evidence: `src/components/App.js`)
- Redux store → Async middleware: applies middleware (evidence: `src/store.js`)
- Redux store → Root reducer: uses reducer (evidence: `src/store.js`)
- Root reducer → Feed state: combines (evidence: `src/reducer.js`)
- Root reducer → Session state: combines (evidence: `src/reducer.js`)
- Root reducer → Article state: combines (evidence: `src/reducer.js`)
- Root reducer → Editor state: combines (evidence: `src/reducer.js`)
- Root reducer → Auth state: combines (evidence: `src/reducer.js`)
- Async middleware → API agent: sets auth token (evidence: `src/middleware.js`)
- API agent → Redux store: returns responses
