How ga-el/cbtis224 works
Project Type & Purpose
• This is a static site generator (SSG) project built with Astro.
• Its primary function is to transform .astro templates and Markdown/JSX content into static HTML/CSS/JS and deploy to Netlify for CDN-backed hosting.
Main Architectural Components
a. Developer Environment
• Local file tree: /src/pages, /src/layouts, /src/assets, /public/
• Astro CLI & Node.js runtime
• Version control (Git) in .gitignore/.vscode
b. Build System
• Astro build pipeline (npm run build)
• Static output folder (dist/—not shown but implied)
c. Hosting & Deployment
• Netlify (configured via netlify.toml)
• CDN edge nodes serving static assets
d. Client
• Browser fetching static assets (HTML/CSS/JS, images)
Relationships & Data Flow
• Developer pushes code → Git repository
• Netlify hooks into Git → triggers Astro build
• Astro CLI reads /src + /public → generates /dist
• Netlify deploys /dist to CDN
• End user’s browser requests pages/assets from CDN
Architectural Patterns & Design Principles
• File-based routing: every .astro in /src/pages becomes a route.
• Separation of concerns:
• /src/layouts define wrappers for page content
• /src/assets & /public for static media
• Static Site Generation (SSG) for performance and security
Key Technologies & Frameworks
• Astro (core SSG framework)
• Node.js & npm scripts (package.json, package-lock.json)
• Netlify for CI/CD and global distribution
• TypeScript support (tsconfig.json)
• Optional tooling: VSCode for local dev (.vscode/)