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. The current source content is exported HTML plus CSS, JavaScript, images, PDFs, and other static assets.

Working Rules

• All files in this repository may be changed when needed.
• 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.

Repo Map

Path	What it is
website/index.html	Home page
website/about.html	About page
website/contact.html	Contact page with the form
website/	Source HTML pages, blog posts, speech archives, categories, and tags
website/PAGES.md	Map from old folder paths to current HTML paths
content/	Extracted Markdown archive for speeches and blog posts
src/pages/	Astro endpoints that generate static output from website/
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 the Nginx preview:

npm run build

docker compose up

Then open:

http://localhost:8080/