# danielbdt-git/stus-news-web architecture

> Architecture diagram of the GitHub repository danielbdt-git/stus-news-web, 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/danielbdt-git/stus-news-web
- Repository: https://github.com/danielbdt-git/stus-news-web

## Overview

Stu’s News is an Astro-based news website. Its documented content workflow is for contributors to add Markdown stories under `src/pages/stories`, with frontmatter selecting `StoryLayout.astro`; the site also has home and about pages and shared presentation components. The available source excerpts cover only package and Astro configuration, so runtime page-to-component relationships and other implementation details are not verified and are omitted.

Main entry points: [`src/pages/stories`](https://github.com/danielbdt-git/stus-news-web/tree/master/src/pages/stories) (Markdown stories), [`src/layouts/StoryLayout.astro`](https://github.com/danielbdt-git/stus-news-web/blob/master/src/layouts/StoryLayout.astro) (Story layout)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Story content"]
  node_story_files["Markdown stories"]
  node_member_data["Member data<br/>[members.json]"]
end

subgraph group_pages["Site pages"]
  node_home_page["Home page<br/>[index.astro]"]
  node_about_page["About page<br/>[about.astro]"]
end

subgraph group_presentation["Presentation"]
  node_story_layout["Story layout<br/>[StoryLayout.astro]"]
  node_base_layout["Base layout<br/>[BaseLayout.astro]"]
  node_shared_components["Shared components"]
end

node_contributor(("Contributor"))

node_contributor -->|"adds stories"| node_story_files
node_story_files -->|"selects layout"| node_story_layout

click node_story_files "https://github.com/danielbdt-git/stus-news-web/tree/master/src/pages/stories"
click node_story_layout "https://github.com/danielbdt-git/stus-news-web/blob/master/src/layouts/StoryLayout.astro"
click node_home_page "https://github.com/danielbdt-git/stus-news-web/blob/master/src/pages/index.astro"
click node_about_page "https://github.com/danielbdt-git/stus-news-web/blob/master/src/pages/about.astro"
click node_base_layout "https://github.com/danielbdt-git/stus-news-web/blob/master/src/layouts/BaseLayout.astro"
click node_shared_components "https://github.com/danielbdt-git/stus-news-web/tree/master/src/components"
click node_member_data "https://github.com/danielbdt-git/stus-news-web/blob/master/src/members.json"

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_story_files,node_member_data toneBlue
class node_home_page,node_about_page toneAmber
class node_story_layout,node_base_layout,node_shared_components toneMint
class node_contributor toneIndigo
```

## Components

### Story content

- [Markdown stories](https://github.com/danielbdt-git/stus-news-web/tree/master/src/pages/stories): `src/pages/stories`
- [Member data](https://github.com/danielbdt-git/stus-news-web/blob/master/src/members.json): `src/members.json`

### Site pages

- [Home page](https://github.com/danielbdt-git/stus-news-web/blob/master/src/pages/index.astro): `src/pages/index.astro`
- [About page](https://github.com/danielbdt-git/stus-news-web/blob/master/src/pages/about.astro): `src/pages/about.astro`

### Presentation

- [Story layout](https://github.com/danielbdt-git/stus-news-web/blob/master/src/layouts/StoryLayout.astro): `src/layouts/StoryLayout.astro`
- [Base layout](https://github.com/danielbdt-git/stus-news-web/blob/master/src/layouts/BaseLayout.astro): `src/layouts/BaseLayout.astro`
- [Shared components](https://github.com/danielbdt-git/stus-news-web/tree/master/src/components): `src/components`

### Other components

- **Contributor**

## Connections

- Contributor → Markdown stories: adds stories (evidence: `README.md`)
- Markdown stories → Story layout: selects layout (evidence: `README.md`)
