# sivuraimo/dd-astro-template architecture

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

- Interactive diagram: https://gitdiagram.com/sivuraimo/dd-astro-template
- Repository: https://github.com/sivuraimo/dd-astro-template

## Overview

DD Astro Template is a starter for static Astro sites. Its main user-facing flow is a visitor requesting a page; the template also provides a not-found route, SEO-oriented metadata/styles, and robots/sitemap support. The README documents the intended layout and asset roles, while the sampled source confirms the robots response, sitemap integration, and GSAP plugin registration. Page-to-layout wiring and other unsampled implementation details are not asserted.

Main entry points: [`src/pages/robots.txt.ts`](https://github.com/sivuraimo/dd-astro-template/blob/main/src/pages/robots.txt.ts) (Robots route), [`src/layouts/Layout.astro`](https://github.com/sivuraimo/dd-astro-template/blob/main/src/layouts/Layout.astro) (Site layout), [`src/scripts/gsap.ts`](https://github.com/sivuraimo/dd-astro-template/blob/main/src/scripts/gsap.ts) (Animation setup), [`src/pages/index.astro`](https://github.com/sivuraimo/dd-astro-template/blob/main/src/pages/index.astro) (Home route)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_pages["Page delivery"]
  node_home["Home route<br/>[index.astro]"]
  node_notfound["Not-found route<br/>[404.astro]"]
end

subgraph group_presentation["Presentation"]
  node_layout["Site layout<br/>[Layout.astro]"]
  node_siteconfig["Site settings<br/>[site.ts]"]
  node_styles["Global styles<br/>[global.scss]"]
  node_assets["Site assets"]
  node_gsap["Animation setup<br/>[gsap.ts]"]
  node_scrolltrigger["ScrollTrigger"]
end

subgraph group_seo["SEO and discovery"]
  node_robots["Robots route<br/>[robots.txt.ts]"]
  node_sitemap["Sitemap integration<br/>[astro.config.mjs]"]
end

node_visitor(("Site visitor"))

node_visitor -->|"requests page"| node_home
node_visitor -->|"requests missing page"| node_notfound
node_visitor -->|"requests robots"| node_robots
node_layout -->|"provides styles"| node_styles
node_robots -->|"advertises sitemap"| node_sitemap
node_gsap -->|"registers plugin"| node_scrolltrigger

click node_home "https://github.com/sivuraimo/dd-astro-template/blob/main/src/pages/index.astro"
click node_notfound "https://github.com/sivuraimo/dd-astro-template/blob/main/src/pages/404.astro"
click node_robots "https://github.com/sivuraimo/dd-astro-template/blob/main/src/pages/robots.txt.ts"
click node_layout "https://github.com/sivuraimo/dd-astro-template/blob/main/src/layouts/Layout.astro"
click node_siteconfig "https://github.com/sivuraimo/dd-astro-template/blob/main/src/data/site.ts"
click node_styles "https://github.com/sivuraimo/dd-astro-template/blob/main/src/styles/global.scss"
click node_assets "https://github.com/sivuraimo/dd-astro-template/tree/main/src/assets"
click node_gsap "https://github.com/sivuraimo/dd-astro-template/blob/main/src/scripts/gsap.ts"
click node_sitemap "https://github.com/sivuraimo/dd-astro-template/blob/main/astro.config.mjs"

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_notfound toneBlue
class node_layout,node_siteconfig,node_styles,node_assets,node_gsap,node_scrolltrigger toneAmber
class node_robots,node_sitemap toneMint
class node_visitor toneIndigo
```

## Components

### Page delivery

- [Home route](https://github.com/sivuraimo/dd-astro-template/blob/main/src/pages/index.astro): `src/pages/index.astro`
- [Not-found route](https://github.com/sivuraimo/dd-astro-template/blob/main/src/pages/404.astro): `src/pages/404.astro`

### Presentation

- [Site layout](https://github.com/sivuraimo/dd-astro-template/blob/main/src/layouts/Layout.astro): `src/layouts/Layout.astro`
- [Site settings](https://github.com/sivuraimo/dd-astro-template/blob/main/src/data/site.ts): `src/data/site.ts`
- [Global styles](https://github.com/sivuraimo/dd-astro-template/blob/main/src/styles/global.scss): `src/styles/global.scss`
- [Site assets](https://github.com/sivuraimo/dd-astro-template/tree/main/src/assets): `src/assets`
- [Animation setup](https://github.com/sivuraimo/dd-astro-template/blob/main/src/scripts/gsap.ts): `src/scripts/gsap.ts`
- **ScrollTrigger**

### SEO and discovery

- [Robots route](https://github.com/sivuraimo/dd-astro-template/blob/main/src/pages/robots.txt.ts): `src/pages/robots.txt.ts`
- [Sitemap integration](https://github.com/sivuraimo/dd-astro-template/blob/main/astro.config.mjs): `astro.config.mjs`

### Other components

- **Site visitor**

## Connections

- Site visitor → Home route: requests page (evidence: `README.md`)
- Site visitor → Not-found route: requests missing page (evidence: `README.md`)
- Site visitor → Robots route: requests robots (evidence: `README.md`)
- Site layout → Global styles: provides styles (evidence: `README.md`)
- Robots route → Sitemap integration: advertises sitemap (evidence: `src/pages/robots.txt.ts`)
- Animation setup → ScrollTrigger: registers plugin (evidence: `src/scripts/gsap.ts`)
