# sadanandpai/frontend-mini-challenges architecture

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

- Interactive diagram: https://gitdiagram.com/sadanandpai/frontend-mini-challenges
- Repository: https://github.com/sadanandpai/frontend-mini-challenges

## Overview

Frontend Mini Challenges is a learning and interview-practice collection: visitors browse challenge listings, choose a technology and challenge, then interact with a solution and inspect its implementation. The host provides the home, technology challenge listings, and leaderboard; separate JavaScript, CSS, React, Vue, and Angular apps hold challenge implementations, while shared data describes challenge content and types. The README documents the collection and supported frameworks. Some app internals were not sampled, so links between the host catalog and individual challenge runtimes are not asserted.

Main entry points: [`apps/host/src/main.tsx`](https://github.com/sadanandpai/frontend-mini-challenges/blob/main/apps/host/src/main.tsx) (Portal router), [`apps/angular/src/app/routes.ts`](https://github.com/sadanandpai/frontend-mini-challenges/blob/main/apps/angular/src/app/routes.ts) (Angular routes), [`shared/data/content/js-challenges.ts`](https://github.com/sadanandpai/frontend-mini-challenges/blob/main/shared/data/content/js-challenges.ts) (JS challenge catalog), [`apps/react/src/challenges/anuvadak/App.tsx`](https://github.com/sadanandpai/frontend-mini-challenges/blob/main/apps/react/src/challenges/anuvadak/App.tsx) (Translation challenge)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_host["Challenge portal"]
  node_portal["Portal router<br/>[main.tsx]"]
  node_home["Home page<br/>[home.tsx]"]
  node_listings["Challenge listings<br/>[challenges.tsx]"]
  node_leaderboard["Leaderboard page<br/>[leaderboard.tsx]"]
end

subgraph group_shared["Shared catalog"]
  node_jscontent["JS challenge catalog<br/>[js-challenges.ts]"]
  node_challenge_types["Challenge types<br/>[challenge.ts]"]
  node_challenge_helpers["Catalog helpers"]
end

subgraph group_browser["Browser challenges"]
  node_javascript["JavaScript solutions"]
  node_css["CSS challenges"]
end

subgraph group_react["React challenges"]
  node_react_entry["React challenge page<br/>[Challenge.tsx]"]
  node_react_solutions["React solutions"]
  node_translator["Translation challenge<br/>[App.tsx]"]
  node_translation_ui["Translation controls"]
  node_translation_api{{"Translation service"}}
end

subgraph group_vue["Vue challenges"]
  node_vue_entry["Vue challenge page<br/>[challenge.vue]"]
  node_vue_routes["Vue routes<br/>[routes.ts]"]
  node_vue_solutions["Vue solutions"]
end

subgraph group_angular["Angular challenges"]
  node_angular_routes["Angular routes<br/>[routes.ts]"]
  node_angular_shell["Challenge container"]
  node_angular_solutions["Angular solutions"]
  node_angular_nav["Angular navigation"]
end

node_visitor(("Challenge visitor"))

node_visitor -->|"opens"| node_portal
node_portal -->|"routes to"| node_home
node_portal -->|"routes to"| node_listings
node_portal -->|"routes to"| node_leaderboard
node_jscontent -->|"uses types"| node_challenge_types
node_jscontent -->|"uses helpers"| node_challenge_helpers
node_visitor -->|"plays solutions"| node_javascript
node_visitor -->|"explores challenges"| node_css
node_visitor -->|"opens challenges"| node_react_entry
node_react_entry -.->|"selects from"| node_react_solutions
node_visitor -->|"opens challenges"| node_vue_entry
node_vue_routes -->|"routes to"| node_vue_entry
node_vue_routes -->|"routes to"| node_vue_solutions
node_visitor -->|"opens challenges"| node_angular_routes
node_angular_routes -->|"routes to"| node_angular_shell
node_angular_routes -->|"loads challenges"| node_angular_solutions
node_angular_shell -->|"uses navigation"| node_angular_nav
node_translator -->|"renders selector"| node_translation_ui
node_translator -->|"requests translation"| node_translation_api

click node_portal "https://github.com/sadanandpai/frontend-mini-challenges/blob/main/apps/host/src/main.tsx"
click node_home "https://github.com/sadanandpai/frontend-mini-challenges/blob/main/apps/host/src/pages/home.tsx"
click node_listings "https://github.com/sadanandpai/frontend-mini-challenges/blob/main/apps/host/src/pages/challenges.tsx"
click node_leaderboard "https://github.com/sadanandpai/frontend-mini-challenges/blob/main/apps/host/src/pages/leaderboard.tsx"
click node_jscontent "https://github.com/sadanandpai/frontend-mini-challenges/blob/main/shared/data/content/js-challenges.ts"
click node_challenge_types "https://github.com/sadanandpai/frontend-mini-challenges/blob/main/shared/data/types/challenge.ts"
click node_challenge_helpers "https://github.com/sadanandpai/frontend-mini-challenges/blob/main/shared/data/utils/challenges.helper.ts"
click node_javascript "https://github.com/sadanandpai/frontend-mini-challenges/tree/main/apps/javascript/src/challenges"
click node_css "https://github.com/sadanandpai/frontend-mini-challenges/tree/main/apps/css/src/challenges"
click node_react_entry "https://github.com/sadanandpai/frontend-mini-challenges/blob/main/apps/react/src/pages/Challenge.tsx"
click node_react_solutions "https://github.com/sadanandpai/frontend-mini-challenges/tree/main/apps/react/src/challenges"
click node_translator "https://github.com/sadanandpai/frontend-mini-challenges/blob/main/apps/react/src/challenges/anuvadak/App.tsx"
click node_translation_ui "https://github.com/sadanandpai/frontend-mini-challenges/blob/main/apps/react/src/challenges/anuvadak/components/LanguageSelector.tsx"
click node_vue_entry "https://github.com/sadanandpai/frontend-mini-challenges/blob/main/apps/vue/src/pages/challenge.vue"
click node_vue_routes "https://github.com/sadanandpai/frontend-mini-challenges/blob/main/apps/vue/src/routes.ts"
click node_vue_solutions "https://github.com/sadanandpai/frontend-mini-challenges/tree/main/apps/vue/src/challenges"
click node_angular_routes "https://github.com/sadanandpai/frontend-mini-challenges/blob/main/apps/angular/src/app/routes.ts"
click node_angular_shell "https://github.com/sadanandpai/frontend-mini-challenges/blob/main/apps/angular/src/app/components/challenge-container/challenge-container.component.ts"
click node_angular_solutions "https://github.com/sadanandpai/frontend-mini-challenges/tree/main/apps/angular/src/app/challenges"
click node_angular_nav "https://github.com/sadanandpai/frontend-mini-challenges/blob/main/apps/angular/src/app/components/navbar/navbar.component.ts"

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_portal,node_home,node_listings,node_leaderboard toneBlue
class node_jscontent,node_challenge_types,node_challenge_helpers toneAmber
class node_javascript,node_css toneMint
class node_react_entry,node_react_solutions,node_translator,node_translation_ui,node_translation_api toneRose
class node_vue_entry,node_vue_routes,node_vue_solutions,node_visitor toneIndigo
class node_angular_routes,node_angular_shell,node_angular_solutions,node_angular_nav toneTeal
```

## Components

### Challenge portal

- [Portal router](https://github.com/sadanandpai/frontend-mini-challenges/blob/main/apps/host/src/main.tsx): `apps/host/src/main.tsx`
- [Home page](https://github.com/sadanandpai/frontend-mini-challenges/blob/main/apps/host/src/pages/home.tsx): `apps/host/src/pages/home.tsx`
- [Challenge listings](https://github.com/sadanandpai/frontend-mini-challenges/blob/main/apps/host/src/pages/challenges.tsx): `apps/host/src/pages/challenges.tsx`
- [Leaderboard page](https://github.com/sadanandpai/frontend-mini-challenges/blob/main/apps/host/src/pages/leaderboard.tsx): `apps/host/src/pages/leaderboard.tsx`

### Shared catalog

- [JS challenge catalog](https://github.com/sadanandpai/frontend-mini-challenges/blob/main/shared/data/content/js-challenges.ts): `shared/data/content/js-challenges.ts`
- [Challenge types](https://github.com/sadanandpai/frontend-mini-challenges/blob/main/shared/data/types/challenge.ts): `shared/data/types/challenge.ts`
- [Catalog helpers](https://github.com/sadanandpai/frontend-mini-challenges/blob/main/shared/data/utils/challenges.helper.ts): `shared/data/utils/challenges.helper.ts`

### Browser challenges

- [JavaScript solutions](https://github.com/sadanandpai/frontend-mini-challenges/tree/main/apps/javascript/src/challenges): `apps/javascript/src/challenges`
- [CSS challenges](https://github.com/sadanandpai/frontend-mini-challenges/tree/main/apps/css/src/challenges): `apps/css/src/challenges`

### React challenges

- [React challenge page](https://github.com/sadanandpai/frontend-mini-challenges/blob/main/apps/react/src/pages/Challenge.tsx): `apps/react/src/pages/Challenge.tsx`
- [React solutions](https://github.com/sadanandpai/frontend-mini-challenges/tree/main/apps/react/src/challenges): `apps/react/src/challenges`
- [Translation challenge](https://github.com/sadanandpai/frontend-mini-challenges/blob/main/apps/react/src/challenges/anuvadak/App.tsx): `apps/react/src/challenges/anuvadak/App.tsx`
- [Translation controls](https://github.com/sadanandpai/frontend-mini-challenges/blob/main/apps/react/src/challenges/anuvadak/components/LanguageSelector.tsx): `apps/react/src/challenges/anuvadak/components/LanguageSelector.tsx`
- **Translation service**

### Vue challenges

- [Vue challenge page](https://github.com/sadanandpai/frontend-mini-challenges/blob/main/apps/vue/src/pages/challenge.vue): `apps/vue/src/pages/challenge.vue`
- [Vue routes](https://github.com/sadanandpai/frontend-mini-challenges/blob/main/apps/vue/src/routes.ts): `apps/vue/src/routes.ts`
- [Vue solutions](https://github.com/sadanandpai/frontend-mini-challenges/tree/main/apps/vue/src/challenges): `apps/vue/src/challenges`

### Angular challenges

- [Angular routes](https://github.com/sadanandpai/frontend-mini-challenges/blob/main/apps/angular/src/app/routes.ts): `apps/angular/src/app/routes.ts`
- [Challenge container](https://github.com/sadanandpai/frontend-mini-challenges/blob/main/apps/angular/src/app/components/challenge-container/challenge-container.component.ts): `apps/angular/src/app/components/challenge-container/challenge-container.component.ts`
- [Angular solutions](https://github.com/sadanandpai/frontend-mini-challenges/tree/main/apps/angular/src/app/challenges): `apps/angular/src/app/challenges`
- [Angular navigation](https://github.com/sadanandpai/frontend-mini-challenges/blob/main/apps/angular/src/app/components/navbar/navbar.component.ts): `apps/angular/src/app/components/navbar/navbar.component.ts`

### Other components

- **Challenge visitor**

## Connections

- Challenge visitor → Portal router: opens (evidence: `README.md`)
- Portal router → Home page: routes to (evidence: `apps/host/src/main.tsx`)
- Portal router → Challenge listings: routes to (evidence: `apps/host/src/main.tsx`)
- Portal router → Leaderboard page: routes to (evidence: `apps/host/src/main.tsx`)
- JS challenge catalog → Challenge types: uses types (evidence: `shared/data/content/js-challenges.ts`)
- JS challenge catalog → Catalog helpers: uses helpers (evidence: `shared/data/content/js-challenges.ts`)
- Challenge visitor → JavaScript solutions: plays solutions (evidence: `README.md`)
- Challenge visitor → CSS challenges: explores challenges (evidence: `README.md`)
- Challenge visitor → React challenge page: opens challenges (evidence: `README.md`)
- React challenge page → React solutions: selects from
- Challenge visitor → Vue challenge page: opens challenges (evidence: `README.md`)
- Vue routes → Vue challenge page: routes to (evidence: `apps/vue/src/routes.ts`)
- Vue routes → Vue solutions: routes to (evidence: `apps/vue/src/routes.ts`)
- Challenge visitor → Angular routes: opens challenges (evidence: `README.md`)
- Angular routes → Challenge container: routes to (evidence: `apps/angular/src/app/routes.ts`)
- Angular routes → Angular solutions: loads challenges (evidence: `apps/angular/src/app/routes.ts`)
- Challenge container → Angular navigation: uses navigation (evidence: `apps/angular/src/app/components/challenge-container/challenge-container.component.ts`)
- Translation challenge → Translation controls: renders selector (evidence: `apps/react/src/challenges/anuvadak/App.tsx`)
- Translation challenge → Translation service: requests translation (evidence: `apps/react/src/challenges/anuvadak/App.tsx`)
