# redward42/astrofy architecture

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

- Interactive diagram: https://gitdiagram.com/redward42/astrofy
- Repository: https://github.com/redward42/astrofy

## Overview

Astrofy is a customizable Astro portfolio site whose visitor-facing workflow is navigation from shared site chrome to portfolio pages, articles, or store items. Blog and store content is authored as collections and rendered through routes and layouts; the site also exposes a blog RSS feed. The graph preserves the documented CV, projects, services, and homepage branches. Page and component internals were not sampled, so relationships beyond those explicitly described in the README are omitted; documented links cite the README.

Main entry points: [`src/content/blog`](https://github.com/RedWARd42/astrofy/tree/main/src/content/blog) (Blog collection), [`src/layouts/BaseLayout.astro`](https://github.com/RedWARd42/astrofy/blob/main/src/layouts/BaseLayout.astro) (Base layout), [`src/pages/blog/[slug].astro`](https://github.com/RedWARd42/astrofy/blob/main/src/pages/blog/%5Bslug%5D.astro) (Blog post), [`src/pages/store/[slug].astro`](https://github.com/RedWARd42/astrofy/blob/main/src/pages/store/%5Bslug%5D.astro) (Store item)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_routes["Visitor pages"]
  node_home["Home page<br/>[index.astro]"]
  node_projects["Projects page<br/>[projects.astro]"]
  node_services["Services page<br/>[services.astro]"]
  node_cv["CV page<br/>[cv.astro]"]
  node_blog_list["Blog listing<br/>[&#91;...page&#93;.astro]"]
  node_blog_tag["Tagged blog listing<br/>[&#91;...page&#93;.astro]"]
  node_blog_detail["Blog post<br/>[&#91;slug&#93;.astro]"]
  node_store_list["Store listing<br/>[&#91;...page&#93;.astro]"]
  node_store_detail["Store item<br/>[&#91;slug&#93;.astro]"]
  node_not_found["Not found page<br/>[404.astro]"]
  node_rss["Blog RSS feed<br/>[rss.xml.js]"]
end

subgraph group_content["Content collections"]
  node_blog_content[("Blog collection")]
  node_store_content[("Store collection")]
  node_collection_schema["Collection schemas<br/>[config.ts]"]
end

subgraph group_presentation["Layouts and components"]
  node_base_layout["Base layout<br/>[BaseLayout.astro]"]
  node_post_layout["Post layout<br/>[PostLayout.astro]"]
  node_store_layout["Store item layout"]
  node_shared_components["Shared UI components"]
end

subgraph group_site["Site configuration"]
  node_site_config["Site settings<br/>[config.ts]"]
  node_slug_helper["Slug generation<br/>[createSlug.ts]"]
end

node_visitor(("Site visitor"))

node_visitor -->|"visits"| node_home
node_visitor -->|"visits"| node_projects
node_visitor -->|"visits"| node_services
node_visitor -->|"visits"| node_cv
node_visitor -->|"browses"| node_blog_list
node_visitor -->|"browses"| node_blog_tag
node_visitor -->|"reads"| node_blog_detail
node_visitor -->|"browses"| node_store_list
node_visitor -->|"views"| node_store_detail
node_visitor -->|"subscribes"| node_rss
node_home -->|"uses"| node_base_layout
node_projects -->|"uses"| node_base_layout
node_services -->|"uses"| node_base_layout
node_cv -->|"uses"| node_base_layout
node_blog_list -->|"queries"| node_blog_content
node_blog_tag -->|"filters"| node_blog_content
node_blog_detail -->|"loads post"| node_blog_content
node_blog_detail -->|"uses"| node_post_layout
node_store_list -->|"renders items"| node_store_content
node_store_detail -.->|"loads item"| node_store_content
node_store_detail -.->|"uses"| node_store_layout
node_blog_content -->|"validated by"| node_collection_schema
node_store_content -->|"validated by"| node_collection_schema
node_rss -->|"queries"| node_blog_content
node_rss -->|"reads metadata"| node_site_config
node_slug_helper -->|"reads setting"| node_site_config
node_base_layout -->|"includes"| node_shared_components

click node_home "https://github.com/RedWARd42/astrofy/blob/main/src/pages/index.astro"
click node_projects "https://github.com/RedWARd42/astrofy/blob/main/src/pages/projects.astro"
click node_services "https://github.com/RedWARd42/astrofy/blob/main/src/pages/services.astro"
click node_cv "https://github.com/RedWARd42/astrofy/blob/main/src/pages/cv.astro"
click node_blog_list "https://github.com/RedWARd42/astrofy/blob/main/src/pages/blog/%5B...page%5D.astro"
click node_blog_tag "https://github.com/RedWARd42/astrofy/blob/main/src/pages/blog/tag/%5Btag%5D/%5B...page%5D.astro"
click node_blog_detail "https://github.com/RedWARd42/astrofy/blob/main/src/pages/blog/%5Bslug%5D.astro"
click node_store_list "https://github.com/RedWARd42/astrofy/blob/main/src/pages/store/%5B...page%5D.astro"
click node_store_detail "https://github.com/RedWARd42/astrofy/blob/main/src/pages/store/%5Bslug%5D.astro"
click node_not_found "https://github.com/RedWARd42/astrofy/blob/main/src/pages/404.astro"
click node_rss "https://github.com/RedWARd42/astrofy/blob/main/src/pages/rss.xml.js"
click node_blog_content "https://github.com/RedWARd42/astrofy/tree/main/src/content/blog"
click node_store_content "https://github.com/RedWARd42/astrofy/tree/main/src/content/store"
click node_collection_schema "https://github.com/RedWARd42/astrofy/blob/main/src/content/config.ts"
click node_base_layout "https://github.com/RedWARd42/astrofy/blob/main/src/layouts/BaseLayout.astro"
click node_post_layout "https://github.com/RedWARd42/astrofy/blob/main/src/layouts/PostLayout.astro"
click node_store_layout "https://github.com/RedWARd42/astrofy/blob/main/src/layouts/StoreItemLayout.astro"
click node_shared_components "https://github.com/RedWARd42/astrofy/tree/main/src/components"
click node_site_config "https://github.com/RedWARd42/astrofy/blob/main/src/config.ts"
click node_slug_helper "https://github.com/RedWARd42/astrofy/blob/main/src/lib/createSlug.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_home,node_projects,node_services,node_cv,node_blog_list,node_blog_tag,node_blog_detail,node_store_list,node_store_detail,node_not_found,node_rss toneBlue
class node_blog_content,node_store_content,node_collection_schema toneAmber
class node_base_layout,node_post_layout,node_store_layout,node_shared_components toneMint
class node_site_config,node_slug_helper toneRose
class node_visitor toneIndigo
```

## Components

### Visitor pages

- [Home page](https://github.com/RedWARd42/astrofy/blob/main/src/pages/index.astro): `src/pages/index.astro`
- [Projects page](https://github.com/RedWARd42/astrofy/blob/main/src/pages/projects.astro): `src/pages/projects.astro`
- [Services page](https://github.com/RedWARd42/astrofy/blob/main/src/pages/services.astro): `src/pages/services.astro`
- [CV page](https://github.com/RedWARd42/astrofy/blob/main/src/pages/cv.astro): `src/pages/cv.astro`
- [Blog listing](https://github.com/RedWARd42/astrofy/blob/main/src/pages/blog/%5B...page%5D.astro): `src/pages/blog/[...page].astro`
- [Tagged blog listing](https://github.com/RedWARd42/astrofy/blob/main/src/pages/blog/tag/%5Btag%5D/%5B...page%5D.astro): `src/pages/blog/tag/[tag]/[...page].astro`
- [Blog post](https://github.com/RedWARd42/astrofy/blob/main/src/pages/blog/%5Bslug%5D.astro): `src/pages/blog/[slug].astro`
- [Store listing](https://github.com/RedWARd42/astrofy/blob/main/src/pages/store/%5B...page%5D.astro): `src/pages/store/[...page].astro`
- [Store item](https://github.com/RedWARd42/astrofy/blob/main/src/pages/store/%5Bslug%5D.astro): `src/pages/store/[slug].astro`
- [Not found page](https://github.com/RedWARd42/astrofy/blob/main/src/pages/404.astro): `src/pages/404.astro`
- [Blog RSS feed](https://github.com/RedWARd42/astrofy/blob/main/src/pages/rss.xml.js): `src/pages/rss.xml.js`

### Content collections

- [Blog collection](https://github.com/RedWARd42/astrofy/tree/main/src/content/blog): `src/content/blog`
- [Store collection](https://github.com/RedWARd42/astrofy/tree/main/src/content/store): `src/content/store`
- [Collection schemas](https://github.com/RedWARd42/astrofy/blob/main/src/content/config.ts): `src/content/config.ts`

### Layouts and components

- [Base layout](https://github.com/RedWARd42/astrofy/blob/main/src/layouts/BaseLayout.astro): `src/layouts/BaseLayout.astro`
- [Post layout](https://github.com/RedWARd42/astrofy/blob/main/src/layouts/PostLayout.astro): `src/layouts/PostLayout.astro`
- [Store item layout](https://github.com/RedWARd42/astrofy/blob/main/src/layouts/StoreItemLayout.astro): `src/layouts/StoreItemLayout.astro`
- [Shared UI components](https://github.com/RedWARd42/astrofy/tree/main/src/components): `src/components`

### Site configuration

- [Site settings](https://github.com/RedWARd42/astrofy/blob/main/src/config.ts): `src/config.ts`
- [Slug generation](https://github.com/RedWARd42/astrofy/blob/main/src/lib/createSlug.ts): `src/lib/createSlug.ts`

### Other components

- **Site visitor**

## Connections

- Site visitor → Home page: visits
- Site visitor → Projects page: visits (evidence: `README.md`)
- Site visitor → Services page: visits (evidence: `README.md`)
- Site visitor → CV page: visits (evidence: `README.md`)
- Site visitor → Blog listing: browses (evidence: `README.md`)
- Site visitor → Tagged blog listing: browses
- Site visitor → Blog post: reads (evidence: `README.md`)
- Site visitor → Store listing: browses (evidence: `README.md`)
- Site visitor → Store item: views (evidence: `README.md`)
- Site visitor → Blog RSS feed: subscribes (evidence: `README.md`)
- Home page → Base layout: uses (evidence: `README.md`)
- Projects page → Base layout: uses (evidence: `README.md`)
- Services page → Base layout: uses (evidence: `README.md`)
- CV page → Base layout: uses (evidence: `README.md`)
- Blog listing → Blog collection: queries (evidence: `README.md`)
- Tagged blog listing → Blog collection: filters
- Blog post → Blog collection: loads post (evidence: `README.md`)
- Blog post → Post layout: uses (evidence: `README.md`)
- Store listing → Store collection: renders items (evidence: `README.md`)
- Store item → Store collection: loads item
- Store item → Store item layout: uses
- Blog collection → Collection schemas: validated by (evidence: `README.md`)
- Store collection → Collection schemas: validated by (evidence: `README.md`)
- Blog RSS feed → Blog collection: queries (evidence: `src/pages/rss.xml.js`)
- Blog RSS feed → Site settings: reads metadata (evidence: `src/pages/rss.xml.js`)
- Slug generation → Site settings: reads setting (evidence: `src/lib/createSlug.ts`)
- Base layout → Shared UI components: includes (evidence: `README.md`)
