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.