# avomixs-glitch/freestuffdev architecture

> Architecture diagram of the GitHub repository avomixs-glitch/freestuffdev, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/avomixs-glitch/freestuffdev
- Repository: https://github.com/avomixs-glitch/freestuffdev

## Overview

##### Project type and purpose
- This is a Jamstack-style static website built with Astro. Its sole purpose is to generate and serve a catalog of free developer services (freestuff.dev) by transforming Markdown files into a navigable UI.

##### File structure
- src/content/tools: source data (Markdown files with frontMatter)
- src/components: reusable UI building blocks (Card, AllTags, Header, Sponsors)
- src/layouts: top-level page shells (Layout, Sidebar)
- src/pages: framework-provided file-based routes rendering lists, detail pages, submit page
- public: static assets (banner image, manifest.json)
- astro.config.mjs, tailwind.config.mjs, tsconfig.json, package.json: build and tooling configurations

##### README for additional insights
- Confirms static site generation via Astro
- Content contribution workflow is via pull requests editing Markdown
- No custom backend or server logic—pure SSG

- Data (Markdown files) – e.g. blue rectangles
Markdown → Astro build → Static assets → Hosting/CDN → Browser

## Diagram (Mermaid)

```mermaid
flowchart TD
  subgraph "Developer Machine"
    MD["Markdown Files<br/>(src/content/tools)"]:::data
    Config["Content Config<br/>(src/content/config.ts)"]:::data
    Components["UI Components<br/>(src/components)"]:::data
    Card["Card Component"]:::data
    AllTags["AllTags Component"]:::data
    Header["Header Component"]:::data
    Sponsors["Sponsors Component"]:::data
    Layouts["Layouts<br/>(src/layouts)"]:::data
    Layout["Layout Shell"]:::data
    Sidebar["Sidebar Shell"]:::data
    Pages["Page Routes<br/>(src/pages)"]:::data
    Home["Home/List Page"]:::data
    About["About Page"]:::data
    Recent["Recent Tools Page"]:::data
    Fav["Favorites Page"]:::data
    Submit["Submit Tool Page"]:::data
    Detail["Tool Detail Route"]:::data
    Tags["Tags Listing Route"]:::data
    BuildCfgA["Astro Config<br/>(astro.config.mjs)"]:::build
    BuildCfgT["Tailwind Config<br/>(tailwind.config.mjs)"]:::build
    TS["TypeScript Config<br/>(tsconfig.json)"]:::build
    Package["package.json"]:::build
    Styles["Global Styles<br/>(src/styles/main.sass)"]:::build
    Public["Public Directory<br/>(public)"]:::artifact
  end

  subgraph "CI/CD Pipeline"
    CI["CI/CD Pipeline"]:::process
    Build["Astro Build<br/>(Node.js, Vite, Tailwind)"]:::build
  end

  subgraph "Production"
    Artifacts["Static Artifacts<br/>(HTML/CSS/JS)"]:::artifact
    Hosting["Hosting/CDN"]:::cloud
    Browser["Browser"]:::client
  end

  MD -->|"read"| Build
  Config -->|"load"| Build
  Components -->|"use components"| Build
  Card --> Build
  AllTags --> Build
  Header --> Build
  Sponsors --> Build
  Layouts -->|"use layouts"| Build
  Layout --> Build
  Sidebar --> Build
  Pages -->|"file-based routing"| Build
  Home --> Build
  About --> Build
  Recent --> Build
  Fav --> Build
  Submit --> Build
  Detail --> Build
  Tags --> Build
  BuildCfgA --> Build
  BuildCfgT --> Build
  TS --> Build
  Package --> Build
  Styles --> Build
  Public -->|"include static assets"| Artifacts

  CI -->|"trigger build"| Build
  Build -->|"output"| Artifacts
  Artifacts -->|"deploy"| Hosting
  Hosting -->|"serve"| Browser

  click MD "https://github.com/avomixs-glitch/freestuffdev/tree/main/src/content/tools"
  click Config "https://github.com/avomixs-glitch/freestuffdev/blob/main/src/content/config.ts"
  click Components "https://github.com/avomixs-glitch/freestuffdev/tree/main/src/components"
  click Card "https://github.com/avomixs-glitch/freestuffdev/blob/main/src/components/Card.astro"
  click AllTags "https://github.com/avomixs-glitch/freestuffdev/blob/main/src/components/AllTags.astro"
  click Header "https://github.com/avomixs-glitch/freestuffdev/blob/main/src/components/Header.astro"
  click Sponsors "https://github.com/avomixs-glitch/freestuffdev/blob/main/src/components/Sponsors.astro"
  click Layouts "https://github.com/avomixs-glitch/freestuffdev/tree/main/src/layouts"
  click Layout "https://github.com/avomixs-glitch/freestuffdev/blob/main/src/layouts/Layout.astro"
  click Sidebar "https://github.com/avomixs-glitch/freestuffdev/blob/main/src/layouts/Sidebar.astro"
  click Pages "https://github.com/avomixs-glitch/freestuffdev/tree/main/src/pages"
  click Home "https://github.com/avomixs-glitch/freestuffdev/blob/main/src/pages/index.astro"
  click About "https://github.com/avomixs-glitch/freestuffdev/blob/main/src/pages/about.astro"
  click Recent "https://github.com/avomixs-glitch/freestuffdev/blob/main/src/pages/recent.astro"
  click Fav "https://github.com/avomixs-glitch/freestuffdev/blob/main/src/pages/favorites.astro"
  click Submit "https://github.com/avomixs-glitch/freestuffdev/blob/main/src/pages/submit.astro"
  click Detail "https://github.com/avomixs-glitch/freestuffdev/blob/main/src/pages/alternative/[slug].astro"
  click Tags "https://github.com/avomixs-glitch/freestuffdev/blob/main/src/pages/tags/[slug].astro"
  click BuildCfgA "https://github.com/avomixs-glitch/freestuffdev/blob/main/astro.config.mjs"
  click BuildCfgT "https://github.com/avomixs-glitch/freestuffdev/blob/main/tailwind.config.mjs"
  click TS "https://github.com/avomixs-glitch/freestuffdev/blob/main/tsconfig.json"
  click Package "https://github.com/avomixs-glitch/freestuffdev/blob/main/package.json"
  click Styles "https://github.com/avomixs-glitch/freestuffdev/blob/main/src/styles/main.sass"
  click Public "https://github.com/avomixs-glitch/freestuffdev/tree/main/public"

  classDef data fill:#D0E8FF,stroke:#0284C7,stroke-width:1px
  classDef build fill:#FEF3C7,stroke:#D97706,stroke-width:1px
  classDef artifact fill:#D1FAE5,stroke:#059669,stroke-width:1px
  classDef cloud fill:#E5E7EB,stroke:#6B7280,stroke-width:1px
  classDef client fill:#FCE7F3,stroke:#DB2777,stroke-width:1px
  classDef process fill:#F0F9FF,stroke:#0284C7,stroke-width:1px
```
