# sitcon-tw/camp2026 architecture

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

- Interactive diagram: https://gitdiagram.com/sitcon-tw/camp2026
- Repository: https://github.com/sitcon-tw/camp2026

## Overview

1. **Overall shape**
   - This is a **static event website** built with **Astro**. The repo is organized around build-time page generation rather than a long-running application server.
   - The site is configured to live under the **`/2026` base path**, so routing and asset URLs are scoped to `sitcon.camp/2026`.

2. **Page and route layer**
   - The main entrypoints are in **`src/pages/`**: home, about, schedule, a pre-camp notice page, and a 404 page.
   - Each page is an Astro route that assembles shared sections into a final static HTML page.

3. **Component composition**
   - Reusable UI sections live in **`src/components/`** and represent the major content blocks of the site: hero, header/footer, FAQ, schedule preview, registration info, team, student comments, brand marquees, and event summaries.
   - The pages appear to be built by composing these blocks in different combinations, which keeps content structure consistent across routes.

4. **Data-driven content**
   - Most site content is separated into **`src/data/`** as JSON and TypeScript modules: home copy, about copy, layout metadata, registration timeline, schedule data, and team data.
   - This suggests a build-time data flow of **structured content → Astro components → generated pages**, with TypeScript used where derived or typed data is needed.

5. **Layout and global design system**
   - **`src/layouts/Layout.astro`** provides the shared outer shell for the site.
   - **`src/styles/global.css`** holds global styling and Tailwind theme tokens, which act as the central design system boundary for colors, typography, and base styles.

6. **Assets pipeline**
   - Visual assets are kept under **`src/assets/`**, grouped by purpose: hero backgrounds, event imagery, avatars, logos/brands, fonts, schedules, and video covers.
   - The README’s guidance to use Astro’s image handling implies that images are processed through the Astro build pipeline rather than referenced as raw files.
   - **`public/`** contains truly static files that should be served as-is, such as `robots.txt` and an `.ics` calendar file.

7. **Dynamic effects and icons**
   - The README explicitly calls out **GSAP** and **Anime.js** for animation, so motion is a secondary client-side concern layered on top of otherwise static pages.
   - Icons come from **unplugin-icons** using the **`ic`** and **`lucide`** sets, which keeps icon usage in the component layer instead of shipping a separate icon service.

8. **Build-time asset preprocessing**
   - The `scripts/` folder contains helper pipelines for **avatar downloading** and **font subsetting**.
   - These scripts imply that some assets are sourced externally or optimized before deployment, so the asset flow is not purely hand-authored; it includes generated/processed artifacts.

9. **Deployment/runtime boundary**
   - The presence of **`wrangler.jsonc`** and **`src/worker.js`** indicates a **Cloudflare Worker / edge deployment boundary** in addition to the static build.
   - In architecture terms, the site is mostly static output, with Worker configuration likely handling deployment/runtime integration around the generated assets.

10. **Quality gates and delivery**
   - Tooling is centered on **pnpm**, **Node 22+**, Astro, and TypeScript, with repo-level enforcement via **Git hooks** and **GitHub Actions**.
   - The documented hook runs build, lint, and Prettier formatting, while `.github/workflows/` contains CI and deploy automation. This makes the delivery pipeline a first-class part of the repo architecture.

11. **Useful mental model for a diagram**
   - The main boundary is: **content/data/assets in the repo → Astro components/layouts → static site build → deployment on Cloudflare edge/static hosting**.
   - There is no obvious application backend, database, or API layer in the repository; the site is fundamentally a **content composition and static delivery system**.

Main entry points: [`src/pages/index.astro`](https://github.com/sitcon-tw/camp2026/blob/main/src/pages/index.astro) (Home), [`src/pages/about/index.astro`](https://github.com/sitcon-tw/camp2026/blob/main/src/pages/about/index.astro) (About), [`src/layouts/Layout.astro`](https://github.com/sitcon-tw/camp2026/blob/main/src/layouts/Layout.astro) (Layout), [`src/styles/global.css`](https://github.com/sitcon-tw/camp2026/blob/main/src/styles/global.css) (Global styles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_group_content["Content"]
  node_node_home["Home<br/>Astro page<br/>[index.astro]"]
  node_node_about["About<br/>Astro page<br/>[index.astro]"]
  node_node_schedule["Schedule<br/>Astro page<br/>[index.astro]"]
  node_node_notice["Pre-camp notice<br/>Astro page<br/>[index.astro]"]
  node_node_not_found["404 page<br/>Astro page<br/>[404.astro]"]
  node_node_layout["Layout<br/>site shell<br/>[Layout.astro]"]
  node_node_header["Header<br/>UI section<br/>[Header.astro]"]
  node_node_footer["Footer<br/>UI section<br/>[Footer.astro]"]
  node_node_hero["Hero<br/>UI section<br/>[Hero.astro]"]
  node_node_registration["Registration<br/>UI section"]
  node_node_schedule_preview["Schedule preview<br/>UI section"]
  node_node_about_section["About camp<br/>UI section"]
  node_node_faq["FAQ<br/>UI section<br/>[FAQ.astro]"]
  node_node_team["Team<br/>UI section<br/>[Team.astro]"]
  node_node_comments["Student comments<br/>UI section"]
  node_node_events["Events held<br/>UI section<br/>[EventsHeld.astro]"]
  node_node_master["Master class<br/>UI section<br/>[MasterClass.astro]"]
  node_node_brand_marquee["Brand marquee<br/>UI section<br/>[BrandMarquee.astro]"]
  node_node_organizer_brands["Organizer brands<br/>UI section"]
  node_node_about_video["About video<br/>UI section<br/>[AboutVideo.astro]"]
  node_node_home_data["Home data<br/>JSON content<br/>[home.json]"]
  node_node_about_data["About data<br/>JSON content<br/>[about.json]"]
  node_node_layout_data["Layout data<br/>JSON content<br/>[layout.json]"]
  node_node_registration_timeline["Registration timeline<br/>JSON content"]
  node_node_registration_ts["Registration data<br/>typed data<br/>[registration.ts]"]
  node_node_schedule_ts["Schedule data<br/>typed data<br/>[schedule.ts]"]
  node_node_teams_data["Teams data<br/>JSON content<br/>[teams.json]"]
  node_node_global_css["Global styles<br/>design system<br/>[global.css]"]
end

subgraph group_group_assets["Assets"]
  node_node_hero_assets[("Hero assets<br/>image assets")]
  node_node_about_assets[("About assets<br/>image assets")]
  node_node_brand_assets[("Brand assets<br/>image assets")]
  node_node_event_assets[("Event assets<br/>image assets")]
  node_node_avatar_assets[("Avatars<br/>image assets")]
  node_node_font_assets[("Fonts<br/>font assets")]
end

subgraph group_group_build["Build"]
end

subgraph group_group_deploy["Deploy"]
end

node_node_home -->|"uses"| node_node_layout
node_node_about -->|"uses"| node_node_layout
node_node_schedule -->|"uses"| node_node_layout
node_node_notice -->|"uses"| node_node_layout
node_node_not_found -->|"uses"| node_node_layout
node_node_layout -->|"includes"| node_node_header
node_node_layout -->|"includes"| node_node_footer
node_node_home -->|"composes"| node_node_hero
node_node_home -->|"composes"| node_node_registration
node_node_home -->|"composes"| node_node_schedule_preview
node_node_home -->|"composes"| node_node_faq
node_node_home -->|"composes"| node_node_comments
node_node_home -->|"composes"| node_node_events
node_node_home -->|"composes"| node_node_brand_marquee
node_node_about -->|"composes"| node_node_about_section
node_node_about -->|"composes"| node_node_about_video
node_node_about -->|"composes"| node_node_master
node_node_about -->|"composes"| node_node_team
node_node_schedule -->|"reads"| node_node_schedule_ts
node_node_home -->|"reads"| node_node_home_data
node_node_about -->|"reads"| node_node_about_data
node_node_layout -->|"reads"| node_node_layout_data
node_node_registration -->|"reads"| node_node_registration_timeline
node_node_registration -->|"reads"| node_node_registration_ts
node_node_team -->|"reads"| node_node_teams_data
node_node_schedule_preview -->|"reads"| node_node_schedule_ts
node_node_hero -->|"uses"| node_node_hero_assets
node_node_about_section -->|"uses"| node_node_about_assets
node_node_brand_marquee -->|"uses"| node_node_brand_assets
node_node_events -->|"uses"| node_node_event_assets
node_node_team -->|"uses"| node_node_avatar_assets
node_node_global_css -->|"styles"| node_node_layout
node_node_home -->|"styles"| node_node_global_css
node_node_about -->|"styles"| node_node_global_css
node_node_schedule -->|"styles"| node_node_global_css
node_node_home -->|"composes"| node_node_organizer_brands
node_node_about -->|"composes"| node_node_organizer_brands

click node_node_home "https://github.com/sitcon-tw/camp2026/blob/main/src/pages/index.astro"
click node_node_about "https://github.com/sitcon-tw/camp2026/blob/main/src/pages/about/index.astro"
click node_node_schedule "https://github.com/sitcon-tw/camp2026/blob/main/src/pages/schedule/index.astro"
click node_node_notice "https://github.com/sitcon-tw/camp2026/blob/main/src/pages/pre-camp-notice/index.astro"
click node_node_not_found "https://github.com/sitcon-tw/camp2026/blob/main/src/pages/404.astro"
click node_node_layout "https://github.com/sitcon-tw/camp2026/blob/main/src/layouts/Layout.astro"
click node_node_header "https://github.com/sitcon-tw/camp2026/blob/main/src/components/Header.astro"
click node_node_footer "https://github.com/sitcon-tw/camp2026/blob/main/src/components/Footer.astro"
click node_node_hero "https://github.com/sitcon-tw/camp2026/blob/main/src/components/Hero.astro"
click node_node_registration "https://github.com/sitcon-tw/camp2026/blob/main/src/components/RegistrationInfo.astro"
click node_node_schedule_preview "https://github.com/sitcon-tw/camp2026/blob/main/src/components/SchedulePreview.astro"
click node_node_about_section "https://github.com/sitcon-tw/camp2026/blob/main/src/components/AboutSitconCamp.astro"
click node_node_faq "https://github.com/sitcon-tw/camp2026/blob/main/src/components/FAQ.astro"
click node_node_team "https://github.com/sitcon-tw/camp2026/blob/main/src/components/Team.astro"
click node_node_comments "https://github.com/sitcon-tw/camp2026/blob/main/src/components/StudentComment.astro"
click node_node_events "https://github.com/sitcon-tw/camp2026/blob/main/src/components/EventsHeld.astro"
click node_node_master "https://github.com/sitcon-tw/camp2026/blob/main/src/components/MasterClass.astro"
click node_node_brand_marquee "https://github.com/sitcon-tw/camp2026/blob/main/src/components/BrandMarquee.astro"
click node_node_organizer_brands "https://github.com/sitcon-tw/camp2026/blob/main/src/components/OrganizerBrands.astro"
click node_node_about_video "https://github.com/sitcon-tw/camp2026/blob/main/src/components/AboutVideo.astro"
click node_node_home_data "https://github.com/sitcon-tw/camp2026/blob/main/src/data/home.json"
click node_node_about_data "https://github.com/sitcon-tw/camp2026/blob/main/src/data/about.json"
click node_node_layout_data "https://github.com/sitcon-tw/camp2026/blob/main/src/data/layout.json"
click node_node_registration_timeline "https://github.com/sitcon-tw/camp2026/blob/main/src/data/registration-timeline.json"
click node_node_registration_ts "https://github.com/sitcon-tw/camp2026/blob/main/src/data/registration.ts"
click node_node_schedule_ts "https://github.com/sitcon-tw/camp2026/blob/main/src/data/schedule.ts"
click node_node_teams_data "https://github.com/sitcon-tw/camp2026/blob/main/src/data/teams.json"
click node_node_global_css "https://github.com/sitcon-tw/camp2026/blob/main/src/styles/global.css"
click node_node_hero_assets "https://github.com/sitcon-tw/camp2026/tree/main/src/assets/hero-wall"
click node_node_about_assets "https://github.com/sitcon-tw/camp2026/tree/main/src/assets/about"
click node_node_brand_assets "https://github.com/sitcon-tw/camp2026/tree/main/src/assets/brand"
click node_node_event_assets "https://github.com/sitcon-tw/camp2026/tree/main/src/assets/events"
click node_node_avatar_assets "https://github.com/sitcon-tw/camp2026/tree/main/src/assets/team-avatars"
click node_node_font_assets "https://github.com/sitcon-tw/camp2026/tree/main/src/assets/fonts"

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_node_home,node_node_about,node_node_schedule,node_node_notice,node_node_not_found,node_node_layout,node_node_header,node_node_footer,node_node_hero,node_node_registration,node_node_schedule_preview,node_node_about_section,node_node_faq,node_node_team,node_node_comments,node_node_events,node_node_master,node_node_brand_marquee,node_node_organizer_brands,node_node_about_video,node_node_home_data,node_node_about_data,node_node_layout_data,node_node_registration_timeline,node_node_registration_ts,node_node_schedule_ts,node_node_teams_data,node_node_global_css toneBlue
class node_node_hero_assets,node_node_about_assets,node_node_brand_assets,node_node_event_assets,node_node_avatar_assets,node_node_font_assets toneAmber
```

## Components

### Content

Routes, reusable UI, and structured site data

- [Home](https://github.com/sitcon-tw/camp2026/blob/main/src/pages/index.astro): Astro page · Main landing page route · `src/pages/index.astro`
- [About](https://github.com/sitcon-tw/camp2026/blob/main/src/pages/about/index.astro): Astro page · About page route · `src/pages/about/index.astro`
- [Schedule](https://github.com/sitcon-tw/camp2026/blob/main/src/pages/schedule/index.astro): Astro page · Schedule page route · `src/pages/schedule/index.astro`
- [Pre-camp notice](https://github.com/sitcon-tw/camp2026/blob/main/src/pages/pre-camp-notice/index.astro): Astro page · Pre-camp notice route · `src/pages/pre-camp-notice/index.astro`
- [404 page](https://github.com/sitcon-tw/camp2026/blob/main/src/pages/404.astro): Astro page · Fallback route for missing pages · `src/pages/404.astro`
- [Layout](https://github.com/sitcon-tw/camp2026/blob/main/src/layouts/Layout.astro): site shell · Shared outer page shell · `src/layouts/Layout.astro`
- [Header](https://github.com/sitcon-tw/camp2026/blob/main/src/components/Header.astro): UI section · Top navigation and branding · `src/components/Header.astro`
- [Footer](https://github.com/sitcon-tw/camp2026/blob/main/src/components/Footer.astro): UI section · Site footer and closing links · `src/components/Footer.astro`
- [Hero](https://github.com/sitcon-tw/camp2026/blob/main/src/components/Hero.astro): UI section · Primary landing hero block · `src/components/Hero.astro`
- [Registration](https://github.com/sitcon-tw/camp2026/blob/main/src/components/RegistrationInfo.astro): UI section · Registration and timeline content · `src/components/RegistrationInfo.astro`
- [Schedule preview](https://github.com/sitcon-tw/camp2026/blob/main/src/components/SchedulePreview.astro): UI section · Homepage schedule summary block · `src/components/SchedulePreview.astro`
- [About camp](https://github.com/sitcon-tw/camp2026/blob/main/src/components/AboutSitconCamp.astro): UI section · Camp overview section · `src/components/AboutSitconCamp.astro`
- [FAQ](https://github.com/sitcon-tw/camp2026/blob/main/src/components/FAQ.astro): UI section · Frequently asked questions block · `src/components/FAQ.astro`
- [Team](https://github.com/sitcon-tw/camp2026/blob/main/src/components/Team.astro): UI section · Organizer and team showcase · `src/components/Team.astro`
- [Student comments](https://github.com/sitcon-tw/camp2026/blob/main/src/components/StudentComment.astro): UI section · Participant testimonials and comments · `src/components/StudentComment.astro`
- [Events held](https://github.com/sitcon-tw/camp2026/blob/main/src/components/EventsHeld.astro): UI section · Past event summary block · `src/components/EventsHeld.astro`
- [Master class](https://github.com/sitcon-tw/camp2026/blob/main/src/components/MasterClass.astro): UI section · Speaker and master class content · `src/components/MasterClass.astro`
- [Brand marquee](https://github.com/sitcon-tw/camp2026/blob/main/src/components/BrandMarquee.astro): UI section · Scrolling brand/logo strip · `src/components/BrandMarquee.astro`
- [Organizer brands](https://github.com/sitcon-tw/camp2026/blob/main/src/components/OrganizerBrands.astro): UI section · Organizer and partner brand block · `src/components/OrganizerBrands.astro`
- [About video](https://github.com/sitcon-tw/camp2026/blob/main/src/components/AboutVideo.astro): UI section · Embedded or presented video block · `src/components/AboutVideo.astro`
- [Home data](https://github.com/sitcon-tw/camp2026/blob/main/src/data/home.json): JSON content · Homepage structured copy and content · `src/data/home.json`
- [About data](https://github.com/sitcon-tw/camp2026/blob/main/src/data/about.json): JSON content · About page structured copy · `src/data/about.json`
- [Layout data](https://github.com/sitcon-tw/camp2026/blob/main/src/data/layout.json): JSON content · Shared metadata for the site shell · `src/data/layout.json`
- [Registration timeline](https://github.com/sitcon-tw/camp2026/blob/main/src/data/registration-timeline.json): JSON content · Registration milestones and dates · `src/data/registration-timeline.json`
- [Registration data](https://github.com/sitcon-tw/camp2026/blob/main/src/data/registration.ts): typed data · Derived registration content and helpers · `src/data/registration.ts`
- [Schedule data](https://github.com/sitcon-tw/camp2026/blob/main/src/data/schedule.ts): typed data · Typed schedule content and structure · `src/data/schedule.ts`
- [Teams data](https://github.com/sitcon-tw/camp2026/blob/main/src/data/teams.json): JSON content · Team and organizer roster data · `src/data/teams.json`
- [Global styles](https://github.com/sitcon-tw/camp2026/blob/main/src/styles/global.css): design system · Base styles and theme tokens · `src/styles/global.css`

### Assets

Static and processed visual/media inputs

- [Hero assets](https://github.com/sitcon-tw/camp2026/tree/main/src/assets/hero-wall): image assets · Hero backgrounds and wall imagery · `src/assets/hero-wall`
- [About assets](https://github.com/sitcon-tw/camp2026/tree/main/src/assets/about): image assets · About page imagery · `src/assets/about`
- [Brand assets](https://github.com/sitcon-tw/camp2026/tree/main/src/assets/brand): image assets · Brand and logo imagery · `src/assets/brand`
- [Event assets](https://github.com/sitcon-tw/camp2026/tree/main/src/assets/events): image assets · Event-related images · `src/assets/events`
- [Avatars](https://github.com/sitcon-tw/camp2026/tree/main/src/assets/team-avatars): image assets · Team and feature member avatars · `src/assets/team-avatars`
- [Fonts](https://github.com/sitcon-tw/camp2026/tree/main/src/assets/fonts): font assets · Source fonts for subsetting · `src/assets/fonts`

## Connections

- Home → Layout: uses · Home page wraps content in the shared shell
- About → Layout: uses · About page wraps content in the shared shell
- Schedule → Layout: uses · Schedule page wraps content in the shared shell
- Pre-camp notice → Layout: uses · Pre-camp notice page wraps content in the shared shell
- 404 page → Layout: uses · 404 page wraps content in the shared shell
- Layout → Header: includes · Shared shell includes site header
- Layout → Footer: includes · Shared shell includes site footer
- Home → Hero: composes · Homepage starts with the hero section
- Home → Registration: composes · Homepage includes registration information
- Home → Schedule preview: composes · Homepage includes schedule summary
- Home → FAQ: composes · Homepage includes FAQ content
- Home → Student comments: composes · Homepage includes student comments
- Home → Events held: composes · Homepage includes past events summary
- Home → Brand marquee: composes · Homepage includes brand marquee
- About → About camp: composes · About page includes camp overview content
- About → About video: composes · About page includes video content
- About → Master class: composes · About page includes master class content
- About → Team: composes · About page includes team content
- Schedule → Schedule data: reads · Schedule page consumes typed schedule data
- Home → Home data: reads · Homepage consumes structured copy data
- About → About data: reads · About page consumes structured copy data
- Layout → Layout data: reads · Shared shell consumes site metadata
- Registration → Registration timeline: reads · Registration section uses milestone timeline
- Registration → Registration data: reads · Registration section uses derived registration data
- Team → Teams data: reads · Team section consumes roster data
- Schedule preview → Schedule data: reads · Preview block summarizes schedule data
- Hero → Hero assets: uses · Hero section pulls from hero imagery
- About camp → About assets: uses · About section pulls from about imagery
- Brand marquee → Brand assets: uses · Brand marquee uses logo assets
- Events held → Event assets: uses · Events section uses event imagery
- Team → Avatars: uses · Team section uses avatar images
- Global styles → Layout: styles · Global design tokens underpin the layout shell
- Home → Global styles: styles · Homepage is styled by global CSS
- About → Global styles: styles · About page is styled by global CSS
- Schedule → Global styles: styles · Schedule page is styled by global CSS
- Home → Organizer brands: composes · Homepage includes organizer brand block
- About → Organizer brands: composes · About page includes organizer brand block
