# 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 |
| `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 the Nginx preview:

```bash
npm run build
```

```bash
docker compose up
```

Then open:

```text
http://localhost:8080/
```