# 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.
- 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:

```bash
npm run dev
```

For a production-style Astro preview:

```bash
npm run build
npm run preview
```

For a build health check:

```bash
npm run check
```

Then open:

```text
http://localhost:4321/
```