familyfedie/familyfedie-website
3
0
Fork 0
Code Issues Pull requests 1 Projects Releases Packages Wiki Activity Actions
familyfedie-website/AGENTS.md
Loyyd 007461b778
All checks were successful
/ deploy (push) Successful in 51s
Details
Document live-first project workflow
2026-07-12 17:54:44 +02:00

2.5 KiB
Raw Blame History

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.

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/