Lyra Astro documentation

Events, stories and team

Publish events with calendar files, write news and stories with tags, and introduce your staff and board.

Events

Events are Markdown files in src/content/events/<lang>/. charity-run.md is published at /events/charity-run/.

---
title: Run for Water 10K
summary: Run, jog or walk 10K along the seafront.
start: 2026-12-06
time: 7am–11am
location: Mombasa seafront, Kenya
image: charity-run.jpg
imageAlt: Two runners in a cross-country race
register: https://your-ticket-page.example
price: $15
---

Bring your family, bring your friends. Water stations every 2K, and breakfast at the finish.
Field What it does
start The date, as YYYY-MM-DD.
end Optional. The last day, for events that run over several days.
time Optional. Shown exactly as written, such as 6pm–9pm.
location Where it happens.
online true for an online event.
register Optional. Your sign-up or ticket link, shown as a Register button.
price Optional. Shown as written, such as $15 or Free.
image, imageAlt, imagePosition Optional photo, as for causes.

Every event page has an Add to calendar button that downloads a calendar file (/events/<file-name>.ics) for Google Calendar, Apple Calendar and Outlook. Events also carry Event structured data, so search engines can show them with their date and place.

The events block lists events with show: upcoming (the default), past or all. Past events move out of “upcoming” when the site is next built, so rebuild now and then, or set up a daily build with your host.

Stories

Stories are your news, field reports and appeals, in src/content/stories/<lang>/.

---
title: "Amina's mornings: from the river to the classroom"
summary: For years, Amina walked two hours to the river before school.
date: 2026-10-14
author: Grace Wanjiru
cause: clean-water
tags: [Water, Children, Kanyawegi]
image: water-well.jpg
imageAlt: A girl washing her face at a village tap
featured: true
---

When the drilling team arrived in Kanyawegi, Amina was the first to ask what they were building.

Write the story in Markdown below the front matter. Put a title in quotes if it contains a colon.

Field What it does
date The publication date. Newest stories come first.
author Optional. Shown with the date.
cause Optional. Links the story to a cause, whose page then lists it.
tags Optional. Each tag gets a page listing its stories, such as /stories/tags/children/.
featured true puts the story in the large spot of the stories block’s featured variant.
image, imageAlt, imagePosition The photo, as for causes.

Each language has an RSS feed of its stories: /rss.xml and /es/rss.xml.

Team

Team members are files in src/content/team/, one per person, shared by every language:

---
name: Grace Wanjiru
role:
  en: Executive Director
  es: Directora ejecutiva
group: staff
order: 1
email: grace@yourcharity.org
photo: grace.jpg
---
Field What it does
role One string, or one per language as above.
group staff, board or ambassadors.
photo Optional. Without a photo, the person’s initials are shown in a coloured circle.
order The position within the group.
email Optional. Shown as a mail link on grid cards.

The team block shows one group, or group: all, as a grid of cards or a compact list.