How markongithub/astro_tutorial works
Project type and purpose
• This is a static-site project built with Astro (a modern static-site generator).
• Purpose: author content in Markdown and Astro components, compile to a fast, deployable HTML/CSS/JS site.
File structure
• Top-level files
• package.json / package-lock.json / tsconfig.json → Node.js + TypeScript config
• astro.config.mjs → Astro build configuration
• .gitignore / .vscode → project housekeeping
• public/ → static assets (images, fonts, favicon, etc.), copied as-is into the final build
• src/
• pages/ → file-based routing: .astro + .md files map to site routes
– index.astro, about.astro, blog.astro
– posts/*.md → individual blog posts
– tags/[tag].astro → dynamic tag pages
– rss.xml.js → RSS generation script
• components/ → reusable UI pieces (Header, Footer, Navigation, etc.), some written in .astro, one in React (Greeting.jsx)
• layouts/ → master layouts (BaseLayout, MarkdownPostLayout) that wrap pages
• scripts/ → plain JS helper (menu toggle)
• styles/ → global.css
README for additional insights
• Describes Astro conventions (src/pages routing, src/components location, public/ for static assets)
• Mentions CLI commands for dev, build, preview