# andrew--r/frontend-case-studies architecture

> Architecture diagram of the GitHub repository andrew--r/frontend-case-studies, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/andrew--r/frontend-case-studies
- Repository: https://github.com/andrew--r/frontend-case-studies

## Overview

Frontend Case Studies is a curated catalog of real-world frontend talks and articles, presented through a website for browsing. The main content model separates companies from case studies: Astro loads TOML data through parsers, validates entries with schemas, and exposes collections to pages and RSS routes. The tree also shows company and case-study pages and reusable display components, but their source was not sampled, so their specific calls and rendering relationships are not asserted. RSS route relationships are based on the sampled route implementations.

Main entry points: [`website/src/content.config.ts`](https://github.com/andrew--r/frontend-case-studies/blob/master/website/src/content.config.ts) (Content collections), [`website/src/pages/companies/[company]/rss.xml.ts`](https://github.com/andrew--r/frontend-case-studies/blob/master/website/src/pages/companies/%5Bcompany%5D/rss.xml.ts) (Company feed), [`website/src/pages/rss.xml.ts`](https://github.com/andrew--r/frontend-case-studies/blob/master/website/src/pages/rss.xml.ts) (Catalog feed), [`website/src/domain/company/lib/index.ts`](https://github.com/andrew--r/frontend-case-studies/blob/master/website/src/domain/company/lib/index.ts) (Company parser)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Catalog content"]
  node_company_data["Company data<br/>[data.toml]"]
  node_study_data["Case study data<br/>[data.toml]"]
  node_collections["Content collections<br/>[content.config.ts]"]
end

subgraph group_domain["Content domain"]
  node_company_parser["Company parser<br/>[index.ts]"]
  node_company_schema["Company schema<br/>[schema.ts]"]
  node_study_parser["Case study parser<br/>[index.ts]"]
  node_study_schema["Case study schema<br/>[schema.ts]"]
end

subgraph group_site["Website experience"]
  node_site_config["Site metadata<br/>[config.ts]"]
  node_home_page["Catalog page<br/>[index.astro]"]
  node_company_list["Company directory<br/>[index.astro]"]
  node_company_page["Company detail<br/>[index.astro]"]
  node_display_components["Display components"]
  node_base_layout["Base layout<br/>[BaseLayout.astro]"]
end

subgraph group_feeds["RSS feeds"]
  node_all_feed["Catalog feed<br/>[rss.xml.ts]"]
  node_company_feed["Company feed<br/>[rss.xml.ts]"]
end

node_reader(("Reader"))

node_company_data -->|"loaded by"| node_collections
node_study_data -->|"loaded by"| node_collections
node_collections -->|"uses parser"| node_company_parser
node_collections -->|"uses parser"| node_study_parser
node_collections -->|"validates with"| node_company_schema
node_collections -->|"validates with"| node_study_schema
node_all_feed -->|"queries collections"| node_collections
node_company_feed -->|"queries companies"| node_company_parser
node_company_feed -->|"queries studies"| node_study_parser
node_all_feed -->|"uses metadata"| node_site_config
node_company_feed -->|"uses metadata"| node_site_config
node_reader -.->|"browses"| node_home_page

click node_company_data "https://github.com/andrew--r/frontend-case-studies/blob/master/website/src/domain/company/data.toml"
click node_study_data "https://github.com/andrew--r/frontend-case-studies/blob/master/website/src/domain/caseStudy/data.toml"
click node_collections "https://github.com/andrew--r/frontend-case-studies/blob/master/website/src/content.config.ts"
click node_company_parser "https://github.com/andrew--r/frontend-case-studies/blob/master/website/src/domain/company/lib/index.ts"
click node_company_schema "https://github.com/andrew--r/frontend-case-studies/blob/master/website/src/domain/company/schema.ts"
click node_study_parser "https://github.com/andrew--r/frontend-case-studies/blob/master/website/src/domain/caseStudy/lib/index.ts"
click node_study_schema "https://github.com/andrew--r/frontend-case-studies/blob/master/website/src/domain/caseStudy/schema.ts"
click node_site_config "https://github.com/andrew--r/frontend-case-studies/blob/master/website/src/config.ts"
click node_home_page "https://github.com/andrew--r/frontend-case-studies/blob/master/website/src/pages/index.astro"
click node_company_list "https://github.com/andrew--r/frontend-case-studies/blob/master/website/src/pages/companies/index.astro"
click node_company_page "https://github.com/andrew--r/frontend-case-studies/blob/master/website/src/pages/companies/%5Bcompany%5D/index.astro"
click node_display_components "https://github.com/andrew--r/frontend-case-studies/tree/master/website/src/components"
click node_base_layout "https://github.com/andrew--r/frontend-case-studies/blob/master/website/src/layouts/BaseLayout.astro"
click node_all_feed "https://github.com/andrew--r/frontend-case-studies/blob/master/website/src/pages/rss.xml.ts"
click node_company_feed "https://github.com/andrew--r/frontend-case-studies/blob/master/website/src/pages/companies/%5Bcompany%5D/rss.xml.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_company_data,node_study_data,node_collections toneBlue
class node_company_parser,node_company_schema,node_study_parser,node_study_schema toneAmber
class node_site_config,node_home_page,node_company_list,node_company_page,node_display_components,node_base_layout toneMint
class node_all_feed,node_company_feed toneRose
class node_reader toneIndigo
```

## Components

### Catalog content

- [Company data](https://github.com/andrew--r/frontend-case-studies/blob/master/website/src/domain/company/data.toml): `website/src/domain/company/data.toml`
- [Case study data](https://github.com/andrew--r/frontend-case-studies/blob/master/website/src/domain/caseStudy/data.toml): `website/src/domain/caseStudy/data.toml`
- [Content collections](https://github.com/andrew--r/frontend-case-studies/blob/master/website/src/content.config.ts): `website/src/content.config.ts`

### Content domain

- [Company parser](https://github.com/andrew--r/frontend-case-studies/blob/master/website/src/domain/company/lib/index.ts): `website/src/domain/company/lib/index.ts`
- [Company schema](https://github.com/andrew--r/frontend-case-studies/blob/master/website/src/domain/company/schema.ts): `website/src/domain/company/schema.ts`
- [Case study parser](https://github.com/andrew--r/frontend-case-studies/blob/master/website/src/domain/caseStudy/lib/index.ts): `website/src/domain/caseStudy/lib/index.ts`
- [Case study schema](https://github.com/andrew--r/frontend-case-studies/blob/master/website/src/domain/caseStudy/schema.ts): `website/src/domain/caseStudy/schema.ts`

### Website experience

- [Site metadata](https://github.com/andrew--r/frontend-case-studies/blob/master/website/src/config.ts): `website/src/config.ts`
- [Catalog page](https://github.com/andrew--r/frontend-case-studies/blob/master/website/src/pages/index.astro): `website/src/pages/index.astro`
- [Company directory](https://github.com/andrew--r/frontend-case-studies/blob/master/website/src/pages/companies/index.astro): `website/src/pages/companies/index.astro`
- [Company detail](https://github.com/andrew--r/frontend-case-studies/blob/master/website/src/pages/companies/%5Bcompany%5D/index.astro): `website/src/pages/companies/[company]/index.astro`
- [Display components](https://github.com/andrew--r/frontend-case-studies/tree/master/website/src/components): `website/src/components`
- [Base layout](https://github.com/andrew--r/frontend-case-studies/blob/master/website/src/layouts/BaseLayout.astro): `website/src/layouts/BaseLayout.astro`

### RSS feeds

- [Catalog feed](https://github.com/andrew--r/frontend-case-studies/blob/master/website/src/pages/rss.xml.ts): `website/src/pages/rss.xml.ts`
- [Company feed](https://github.com/andrew--r/frontend-case-studies/blob/master/website/src/pages/companies/%5Bcompany%5D/rss.xml.ts): `website/src/pages/companies/[company]/rss.xml.ts`

### Other components

- **Reader**

## Connections

- Company data → Content collections: loaded by (evidence: `website/src/content.config.ts`)
- Case study data → Content collections: loaded by (evidence: `website/src/content.config.ts`)
- Content collections → Company parser: uses parser (evidence: `website/src/content.config.ts`)
- Content collections → Case study parser: uses parser (evidence: `website/src/content.config.ts`)
- Content collections → Company schema: validates with (evidence: `website/src/content.config.ts`)
- Content collections → Case study schema: validates with (evidence: `website/src/content.config.ts`)
- Catalog feed → Content collections: queries collections (evidence: `website/src/pages/rss.xml.ts`)
- Company feed → Company parser: queries companies (evidence: `website/src/pages/companies/[company]/rss.xml.ts`)
- Company feed → Case study parser: queries studies (evidence: `website/src/pages/companies/[company]/rss.xml.ts`)
- Catalog feed → Site metadata: uses metadata (evidence: `website/src/pages/rss.xml.ts`)
- Company feed → Site metadata: uses metadata (evidence: `website/src/pages/companies/[company]/rss.xml.ts`)
- Reader → Catalog page: browses (evidence: `readme.md`)
