Cards Frontmatter Guide

Use the following date fields in each card file under src/cards/holidays/, src/cards/classes/, or src/cards/retreats/ so listing pages can display and sort cards correctly.

Put each card in the folder for the page where it should appear:

• src/cards/holidays/ — Activity, holiday & courses (nav: Holidays)
• src/cards/classes/ — Classes
• src/cards/retreats/ — Retreats
• src/cards/old/ — archived cards (not built; see old/README.md)

Overview section (listing cards)

Each card should start with a ## Overview section: a short summary shown on listing pages (retreats, classes, holidays). Keep it to a paragraph or two. The next heading of any level (###, ####, ## Team, etc.) ends the overview — everything after that appears only on the card detail page.

Required basics

• title
• slug
• category
• location
• provider

Optional classification fields

• format: e.g. online, in-person, workshop

Date model

• availability: year-round or scheduled
• date_summary: human-readable text shown on the card
• date_start: YYYY-MM-DD (for scheduled cards where a next start date is known)

Behavior on listing page

• Scheduled cards with date_start are shown first and sorted by soonest date.
• Scheduled cards without date_start are shown after those, sorted by title.
• Year-round cards are shown last, sorted by title.
• If availability, date_summary, or date_start are missing, the page defaults to:
  • availability: year-round
  • date_summary: Available year-round

Examples

Year-round holiday

availability: year-round
date_summary: Available year-round

Scheduled retreat

availability: scheduled
date_start: 2026-06-12
date_summary: 12 June 2026 to 17 June 2026