How sitcon-tw/camp2026 works
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: pages/index.astro Home · about/index.astro About · Layout.astro Layout · global.css Global styles
Components 34
Content
Routes, reusable UI, and structured site data
- Home · Main landing page route
src/pages/index.astro - About · About page route
src/pages/about/index.astro - Schedule · Schedule page route
src/pages/schedule/index.astro - Pre-camp notice · Pre-camp notice route
src/pages/pre-camp-notice/index.astro - 404 page · Fallback route for missing pages
src/pages/404.astro - Layout · Shared outer page shell
src/layouts/Layout.astro - Header · Top navigation and branding
src/components/Header.astro - Footer · Site footer and closing links
src/components/Footer.astro - Hero · Primary landing hero block
src/components/Hero.astro - Registration · Registration and timeline content
src/components/RegistrationInfo.astro - Schedule preview · Homepage schedule summary block
src/components/SchedulePreview.astro - About camp · Camp overview section
src/components/AboutSitconCamp.astro - FAQ · Frequently asked questions block
src/components/FAQ.astro - Team · Organizer and team showcase
src/components/Team.astro - Student comments · Participant testimonials and comments
src/components/StudentComment.astro - Events held · Past event summary block
src/components/EventsHeld.astro - Master class · Speaker and master class content
src/components/MasterClass.astro - Brand marquee · Scrolling brand/logo strip
src/components/BrandMarquee.astro - Organizer brands · Organizer and partner brand block
src/components/OrganizerBrands.astro - About video · Embedded or presented video block
src/components/AboutVideo.astro - Home data · Homepage structured copy and content
src/data/home.json - About data · About page structured copy
src/data/about.json - Layout data · Shared metadata for the site shell
src/data/layout.json - Registration timeline · Registration milestones and dates
src/data/registration-timeline.json - Registration data · Derived registration content and helpers
src/data/registration.ts - Schedule data · Typed schedule content and structure
src/data/schedule.ts - Teams data · Team and organizer roster data
src/data/teams.json - Global styles · Base styles and theme tokens
src/styles/global.css
Assets
Static and processed visual/media inputs
- Hero assets · Hero backgrounds and wall imagery
src/assets/hero-wall - About assets · About page imagery
src/assets/about - Brand assets · Brand and logo imagery
src/assets/brand - Event assets · Event-related images
src/assets/events - Avatars · Team and feature member avatars
src/assets/team-avatars - Fonts · Source fonts for subsetting
src/assets/fonts
Connections 37
- 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