How juanantoniomn/webpoetozo works
Project type and purpose
• This is a static site built with the Astro framework (“Astro Starter Kit: Basics”), organized around markdown-based content (poems and poem collections).
• Purpose: generate a poem-centric website at build time, serving purely static HTML/CSS/JS to end-users.
File structure
• Top-level:
• public/ – static assets (images, favicon) served as-is
• src/ – project source
– assets/ – fonts and images
– components/ – reusable Astro UI components (nav, footer, poema, poemarios, etc.)
– content/ – markdown poems & poemario metadata + config.js + poemas.js (content layer)
– layouts/ – base layout (Layout.astro)
– pages/ – route files: index.astro, dynamic routes at /poema/[slug], /poemarios/[slug]
– script/ – client-side JavaScript (carrusel, transitions, load-more poems)
– styles/ – global CSS (Tailwind)
• astro.config.mjs, tailwind.config.js, tsconfig.json – configuration
• package.json + lock – dependencies & scripts
README
• Minimal Astro starter instructions; confirms static SSG workflow, no runtime backend, deployable to any static host.
a. Main components
• Content Layer: markdown files + content config (src/content)
• Build Engine: Astro compiler + Tailwind CSS processor + Node.js scripts
• Component Library: Astro UI components (src/components) + Layouts
• Pages / Routes: dynamic route definitions in src/pages
• Static Assets: public/, src/assets (images/fonts), src/script, src/styles
• Deployment / Hosting: (e.g., Netlify, Vercel, GitHub Pages / CDN)
b. Relationships & interactions
• Content Layer → (feeds) → Astro Build Engine
• Astro Build Engine → (renders) → Pages using Layouts + Components
• Components → (include) → static assets & client scripts
• Build Engine → (outputs) → Dist folder (static HTML/CSS/JS)
• Dist folder → (deployed to) → Hosting + CDN → Browser
c. Architectural patterns
• Static Site Generation (SSG)
• File-based routing (Astro’s pages directory)
• Component-based UI (Astro components)
• Content-as-data (markdown + JS objects)
d. Technologies / frameworks
• Astro (SSG, .astro files)
• Markdown (poems, poemarios)
• Tailwind CSS (global.css + config)
• Node.js (build scripts)
• Client-side JS modules (carrusel, transitions)
• Optional Deployment: Vercel / Netlify / any CDN