familyfedie-website/AGENTS.md

AGENTS.md - Family Fed Ireland website

This repository is for local work only. Do not treat it as a live production server, and do not avoid changes because of live URL concerns unless the user explicitly says a change must preserve a URL.

What This Is

This is an Astro-built static website. content/ is the future source of truth for editable blog and speech content. archive-source/ keeps legacy exported HTML plus CSS, JavaScript, images, PDFs, and other static assets while the migration continues.

Working Rules

• All files in this repository may be changed when needed.
• For requested website changes, deploy the completed change to the live site by default. Do not start or present a local preview unless the user explicitly asks for one.
• When the user says to move something, move it. Do not only copy it or create a parallel structure unless the user specifically asks for a copy.
• If moving files requires updating links, imports, scripts, stylesheets, image paths, or documentation, update those references too.
• Keep the structure simple and close to what the user asks for.
• .forgejo/ and deployment configuration are not special unless the user says they are.
• Feature-branch Actions build and validate only. Production Garage publishing is restricted to commits on main.

Repo Map

Path	What it is
content/	Future source of truth for editable speeches and blog posts
archive-source/index.html	Legacy exported home page
archive-source/about.html	Legacy exported about page
archive-source/contact.html	Legacy exported contact page with the form
archive-source/	Legacy exported HTML pages, blog posts, speech archives, categories, and tags
archive-source/PAGES.md	Map from old folder paths to current HTML paths
src/pages/	Astro endpoints that generate static output from archive-source/ where routes are not migrated
src/components/	Astro components for shared layout migration
dist/	Generated static output from npm run build
css/	Site-level stylesheets
css/theme.css	Extracted Parabola inline theme settings
css/site.css	Extracted site fixes and homepage/frontpage rules
js/	Site-level scripts
assets/	Images, PDFs, fonts, theme files, uploads, and static vendor files
docs/	Maintainer notes and site-structure documentation

Local Preview

For Astro development:

npm run dev

For a production-style Astro preview:

npm run build
npm run preview

For a build health check:

npm run check

Then open:

http://localhost:4321/