astro-theme-popular 0.6.0 → 0.7.0

package/README.md

@@ -21,6 +21,16 @@ export default defineConfig({
 });
 ```
 
+Override any theme component with your own, without forking:
+
+```js
+popular({ overrides: { Header: './src/overrides/Header.astro' } })
+```
+
+Overridable: `Header`, `Footer`, `Hero`, `EventRow`, `PostCard`,
+`OrganizerCard`, `AuthorBox`, `PageHero`. Your file receives the same props
+the theme component does.
+
 Disable any injected route group when your site replaces it (also the
 answer when you provide your own `/` or `/rss.xml`):
 

package/index.mjs

@@ -6,6 +6,11 @@
  *     integrations: [mdx(), popular()],
  *   });
  *
+ * Override components without forking: popular({ overrides: { Header:
+ *   './src/overrides/Header.astro' } }). Theme code imports overridable
+ * components from popular:component/<Name>; the integration resolves each
+ * to the adopter's file or the theme default.
+ *
  * Theme config (SITE, STRINGS, BRAND, NAV, ...) lives in the adopter's
  * `popular.config.ts` (same named exports as the classic src/config.ts;
  * the shape is the parity contract, see PARITY.md). Theme code reads it
@@ -50,15 +55,29 @@ const ROUTES = {
     ['/organizers/[...page]', 'organizers/[...page].astro'],
     ['/organizers/[...slug]', 'organizers/[slug].astro'],
   ],
-  speakers: [['/speakers/[...slug]', 'speakers/[slug].astro']],
-  venues: [['/venues/[...slug]', 'venues/[slug].astro']],
+  speakers: [
+    ['/speakers', 'speakers/index.astro'],
+    ['/speakers/[...slug]', 'speakers/[slug].astro'],
+  ],
+  venues: [
+    ['/venues', 'venues/index.astro'],
+    ['/venues/[...slug]', 'venues/[slug].astro'],
+  ],
   tags: [['/tags/[tag]/[...page]', 'tags/[tag]/[...page].astro']],
+  // Opt-in talk archive: injected always, but the page only builds when
+  // SITE.talks is true (gated in the route's getStaticPaths).
+  talks: [['/talks/[...page]', 'talks/[...page].astro']],
   rss: [['/rss.xml', 'rss.xml.js']],
   robots: [['/robots.txt', 'robots.txt.ts']],
+  calendar: [['/events/calendar.ics', 'events/calendar.ics.ts']],
+  llms: [['/llms.txt', 'llms.txt.ts']],
 };
 
+const OVERRIDABLE = ['Header', 'Footer', 'Hero', 'EventRow', 'PostCard', 'OrganizerCard', 'AuthorBox', 'PageHero'];
+
 export default function popular(options = {}) {
   const configFile = options.configFile ?? './popular.config.ts';
+  const overrides = options.overrides ?? {};
   return {
     name: 'astro-theme-popular',
     hooks: {
@@ -82,6 +101,20 @@ export default function popular(options = {}) {
                   }
                 },
               },
+              {
+                name: 'popular:component',
+                resolveId(id) {
+                  if (id.startsWith('popular:component/')) return '\0' + id;
+                },
+                load(id) {
+                  if (!id.startsWith('\0popular:component/')) return;
+                  const name = id.slice('\0popular:component/'.length);
+                  const target = overrides[name]
+                    ? path.resolve(root, overrides[name])
+                    : `astro-theme-popular/components/${name}.astro`;
+                  return `export { default } from ${JSON.stringify(target)};`;
+                },
+              },
             ],
           },
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "astro-theme-popular",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Popular: a warm, community-first Astro theme for meetups, clubs and fan communities. Ships as an Astro integration.",
   "type": "module",
   "license": "MIT",

package/schemas.ts

@@ -62,6 +62,17 @@ const events = defineCollection({
     price: z.union([z.number(), z.string()]).optional(), // machine price for Offer
     currency: z.string().optional(), // ISO currency for price
     cost: z.string().optional(), // free-text displayed cost (e.g. "15 CAD")
+    // §3 talk archive (all optional). Simple case: event-level recording/slides
+    // (single-talk meetups). Multi-talk case: a talks[] array, which wins over
+    // the event-level recording/slides when present.
+    recording: z.string().optional(),
+    slides: z.string().optional(),
+    talks: z.array(z.object({
+      title: z.string(),
+      speaker: z.string().optional(), // speaker-collection slug, same resolution as `speakers`
+      recording: z.string().optional(),
+      slides: z.string().optional(),
+    })).optional(),
   }),
 });
 
@@ -114,6 +125,10 @@ const venues = defineCollection({
     photo: z.string().optional(),
     notes: z.string().optional(), // arrival notes inherited by events held here
     accessibility: z.string().optional(),
+    wheelchair: z.boolean().default(false), // step-free access badge
+    transit: z.string().optional(),
+    parking: z.string().optional(),
+    access: z.string().optional(), // freeform markdown: washrooms, quiet space, childcare, scent policy
     website: z.string().optional(),
   }),
 });

package/src/components/DemoBar.astro

@@ -22,6 +22,8 @@ const bar = import.meta.env.DEV ? null : ((cfg as Record<string, any>).DEMO_BAR
       .g-demobar a:hover { color: #fff; background: rgba(255,255,255,0.08); }
       .g-demobar a.is-current { background: var(--color-primary); color: #fff; }
       @media (max-width: 640px) { .g-demobar__label { display: none; } }
+      /* Reserve space so the fixed demo bar never covers the footer credit. */
+      .g-footer__bottom { padding-bottom: 72px; }
     </style>
     <nav class="g-demobar" aria-label="Theme demos">
       <a href="#" data-demo-home><i class="fa-solid fa-star" aria-hidden="true"></i>Popular</a>

package/src/components/EventRow.astro

@@ -2,10 +2,12 @@
 import { SITE, STRINGS } from 'popular:config';
 import type { CollectionEntry } from 'astro:content';
 import { safeCollection } from '../lib/collections';
+import { eventHasRecording } from '../lib/talks';
 
 interface Props { event: CollectionEntry<'events'> }
 const { event } = Astro.props;
 const d = event.data;
+const hasRecording = eventHasRecording(d);
 
 /* Venue: a venueRef to the venues collection wins over the flat fields. */
 const venuePage = d.venueRef ? (await safeCollection('venues')).find((v) => v.id === d.venueRef) : undefined;
@@ -47,6 +49,9 @@ const day = d.date.toLocaleDateString(SITE.locale, { month: 'short', day: 'numer
     {speakerLine && (
       <div class="g-event__meta"><i class="fa-solid fa-microphone-lines" aria-hidden="true"></i>{speakerLine}</div>
     )}
+    {hasRecording && (
+      <div class="g-event__meta"><i class="fa-solid fa-circle-play" aria-hidden="true"></i>{STRINGS.hasRecording}</div>
+    )}
   </div>
   <div class="g-event__aside">
     {d.cancelled

package/src/components/EventsEmpty.astro

@@ -0,0 +1,25 @@
+---
+/** Designed empty state for zero upcoming events (§5). Shown on the home page
+ *  and events list instead of a blank section: a message, then the chat CTA
+ *  (if SITE.community.chat is set, §4) and the calendar-subscribe link.
+ *  The calendar link mirrors Hugo's OutputFormats "Calendar" endpoint. */
+import { SITE, STRINGS } from 'popular:config';
+
+const chat = (SITE as Record<string, any>).community?.chat;
+const calendar = '/events/calendar.ics';
+const external = (url: string) => !url.startsWith('/');
+---
+<div class="g-empty">
+  <span class="g-medallion g-medallion--lg"><i class="fa-solid fa-calendar-day" aria-hidden="true"></i></span>
+  <p class="g-lead">{STRINGS.noUpcomingEvents}</p>
+  {(chat?.url || calendar) && (
+    <div class="g-row" style="justify-content:center">
+      {chat?.url && (
+        <a class="g-btn g-btn--primary" href={chat.url} {...(external(chat.url) ? { rel: 'noopener', target: '_blank' } : {})}>
+          <i class="fa-solid fa-comments" aria-hidden="true"></i> {chat.label ?? STRINGS.joinChat}
+        </a>
+      )}
+      <a class="g-btn g-btn--outline" href={calendar}><i class="fa-solid fa-calendar-plus" aria-hidden="true"></i> {STRINGS.subscribeCalendar}</a>
+    </div>
+  )}
+</div>

package/src/components/Footer.astro

@@ -1,7 +1,10 @@
 ---
-import { SITE, FOOTER, SOCIAL } from 'popular:config';
+import { SITE, FOOTER, SOCIAL, STRINGS } from 'popular:config';
+import { version } from '../../package.json';
 const year = new Date().getFullYear();
 const credit = (FOOTER as { credit?: { label: string; url: string } }).credit;
+const chat = (SITE as Record<string, any>).community?.chat;
+const showVersion = !!credit && credit.url.includes('mariatta.ca');
 ---
 
 <footer class="g-footer">
@@ -35,7 +38,10 @@ const credit = (FOOTER as { credit?: { label: string; url: string } }).credit;
   <div class="g-footer__bottom">
     <div class="g-container">
       <span>© {year} {SITE.title}</span>
-      {credit && <span><a href={credit.url} rel="noopener">{credit.label}</a></span>}
+      {chat && (
+        <span><a href={chat.url} {...(chat.url.startsWith('/') ? {} : { rel: 'noopener', target: '_blank' })}><i class="fa-solid fa-comments" aria-hidden="true"></i> {chat.label ?? STRINGS.joinChat}</a></span>
+      )}
+      {credit && <span><a href={credit.url} rel="noopener">{credit.label}</a>{showVersion && <> · v{version}</>}</span>}
       {FOOTER.tagline && <span>{FOOTER.tagline}</span>}
     </div>
   </div>

package/src/components/Gallery.astro

@@ -0,0 +1,7 @@
+---
+/** Photo gallery (§6): a CSS-grid of <Photo> figures. No JS, no lightbox
+ *  (each photo links to its full-size image). Mirrors the Hugo `gallery`
+ *  shortcode. Use in MDX:
+ *    <Gallery><Photo src="/images/recap-1.jpg" alt="…" caption="…" /></Gallery> */
+---
+<div class="g-gallery"><slot /></div>

package/src/components/Notice.astro

@@ -0,0 +1,19 @@
+---
+/** Site-wide notice banner (§5). Reads optional SITE.notice = { text, url? }.
+ *  Static, not dismissible, no JS. Rendered by BaseLayout above the header.
+ *  Text is inline-markdown rendered (parity with Hugo's notice.html). */
+import { SITE, STRINGS } from 'popular:config';
+import { inlineMarkdown } from '../lib/inline-md';
+
+const notice = (SITE as Record<string, any>).notice;
+const text: string | undefined = notice?.text;
+const html = text ? inlineMarkdown(text) : '';
+---
+{text && (
+  <div class="g-notice" role="status">
+    <div class="g-notice__inner">
+      <i class="fa-solid fa-circle-info" aria-hidden="true"></i>
+      <span><Fragment set:html={html} />{notice.url && <> <a href={notice.url}>{STRINGS.learnMore}</a></>}</span>
+    </div>
+  </div>
+)}

package/src/components/PageHero.astro

@@ -3,12 +3,17 @@ interface Props {
   eyebrow?: string;
   title: string;
   lead?: string;
+  backHref?: string;
+  backLabel?: string;
 }
-const { eyebrow, title, lead } = Astro.props;
+const { eyebrow, title, lead, backHref, backLabel } = Astro.props;
 ---
 
 <header class="g-pagehero">
   <div class="g-container">
+    {backHref && (
+      <div style="margin-bottom:1rem"><a href={backHref} style="display:inline-flex;gap:.4rem;align-items:center;font-size:var(--text-sm);font-weight:var(--weight-medium)"><i class="fa-solid fa-arrow-left" aria-hidden="true"></i> {backLabel}</a></div>
+    )}
     {eyebrow && <span class="g-eyebrow">{eyebrow}</span>}
     <h1>{title}</h1>
     {lead && <p class="g-pagehero__lead">{lead}</p>}

package/src/components/Photo.astro

@@ -0,0 +1,12 @@
+---
+/** A gallery photo (§6). `alt` is required: the build throws with an
+ *  actionable message when it is missing, keeping the image-alt CI green by
+ *  construction. No lightbox, the figure links to the full-size image. */
+interface Props { src: string; alt: string; caption?: string; }
+const { src, alt, caption } = Astro.props;
+if (!alt) throw new Error(`<Photo src="${src}"> requires a non-empty alt`);
+---
+<figure class="g-gallery__item">
+  <a href={src}><img src={src} alt={alt} loading="lazy" decoding="async" /></a>
+  {caption && <figcaption>{caption}</figcaption>}
+</figure>

package/src/components/Pullquote.astro

@@ -0,0 +1,11 @@
+---
+/** Pull-quote (§6): a styled blockquote with optional attribution. Mirrors the
+ *  Hugo `pullquote` shortcode. Use in MDX:
+ *    <Pullquote cite="A happy member">The best Tuesday of my month.</Pullquote> */
+interface Props { cite?: string; }
+const { cite } = Astro.props;
+---
+<figure class="g-pullquote">
+  <blockquote><slot /></blockquote>
+  {cite && <figcaption>{cite}</figcaption>}
+</figure>

package/src/components/SpeakerInvite.astro

@@ -0,0 +1,16 @@
+---
+/** §7: "Your name here?" invite card appended to the speakers list when
+ *  SITE.speakers.invite is true. Links to the /speak/ CFP page. Off by
+ *  default, so sites that do not solicit talks show nothing. */
+import { SITE, STRINGS } from 'popular:config';
+const invite = (SITE as Record<string, any>).speakers?.invite === true;
+---
+{invite && (
+  <div class="g-persona g-persona--primary">
+    <span class="g-medallion g-medallion--lg" aria-hidden="true"><i class="fa-solid fa-microphone-lines"></i></span>
+    <div>
+      <div class="g-persona__name"><a href="/speak/" style="color:inherit">{STRINGS.speakerInviteTitle} <i class="fa-solid fa-arrow-right" aria-hidden="true"></i></a></div>
+      <p class="g-persona__bio">{STRINGS.speakerInviteBody}</p>
+    </div>
+  </div>
+)}

package/src/layouts/BaseLayout.astro

@@ -7,9 +7,10 @@ import '../styles/tokens/spacing.css';
 import '../styles/tokens/elevation.css';
 import '../styles/base.css';
 import '../styles/components.css';
-import Header from '../components/Header.astro';
-import Footer from '../components/Footer.astro';
+import Header from 'popular:component/Header';
+import Footer from 'popular:component/Footer';
 import DemoBar from '../components/DemoBar.astro';
+import Notice from '../components/Notice.astro';
 import { SITE, BRAND, STRINGS } from 'popular:config';
 
 interface Props {
@@ -100,6 +101,7 @@ const brandCss = `html:root{${vars.join(';')}}`;
   </head>
   <body data-copy-label={STRINGS.copyCode} data-checklist-done={STRINGS.checklistDone}>
     <a class="g-skip" href="#main">{STRINGS.skipToContent}</a>
+    <Notice />
     <Header />
     <main id="main">
       <slot />

package/src/lib/ical.ts

@@ -0,0 +1,93 @@
+/** iCalendar feed helpers, mirroring the Hugo events/list.calendar.ics
+ *  template. DTSTART reuses parseEventTime (lib/eventld) so the feed and the
+ *  Event JSON-LD agree. Folding is byte-accurate at 75 octets. */
+import { parseEventTime } from './eventld';
+
+const pad = (n: number) => String(n).padStart(2, '0');
+const enc = new TextEncoder();
+
+function ymd(d: Date): string {
+  return `${d.getUTCFullYear()}${pad(d.getUTCMonth() + 1)}${pad(d.getUTCDate())}`;
+}
+
+export function icsEscape(s: string): string {
+  return s.replace(/\\/g, '\\\\').replace(/;/g, '\;').replace(/,/g, '\\,').replace(/\n/g, '\\n');
+}
+
+/** One content line, CRLF-terminated, folded at 75 octets (continuations
+ *  begin with a space, which counts toward the limit). */
+export function fold(line: string): string {
+  if (enc.encode(line).length <= 75) return line + '\r\n';
+  let out = '';
+  let cur = '';
+  let curBytes = 0;
+  let first = true;
+  for (const ch of line) {
+    const cb = enc.encode(ch).length;
+    const limit = first ? 75 : 74;
+    if (curBytes + cb > limit) {
+      out += (first ? '' : ' ') + cur + '\r\n';
+      first = false;
+      cur = ch;
+      curBytes = cb;
+    } else {
+      cur += ch;
+      curBytes += cb;
+    }
+  }
+  out += (first ? '' : ' ') + cur + '\r\n';
+  return out;
+}
+
+export interface IcsEvent {
+  title: string;
+  date: Date;
+  time?: string;
+  description?: string;
+  checkin?: string;
+  cancelled?: boolean;
+  venue?: { name: string; address?: string };
+  permalink: string;
+}
+
+export function buildIcs(
+  events: IcsEvent[],
+  opts: { siteTitle: string; dtstamp: string; durationMinutes: number },
+): string {
+  const L: string[] = [];
+  L.push(fold('BEGIN:VCALENDAR'));
+  L.push(fold('VERSION:2.0'));
+  L.push(fold(`PRODID:-//${opts.siteTitle}//Popular theme//EN`));
+  L.push(fold('CALSCALE:GREGORIAN'));
+  L.push(fold('METHOD:PUBLISH'));
+  L.push(fold(`X-WR-CALNAME:${opts.siteTitle} events`));
+  for (const e of events) {
+    L.push(fold('BEGIN:VEVENT'));
+    L.push(fold(`UID:${e.permalink}`));
+    L.push(fold(`DTSTAMP:${opts.dtstamp}`));
+    const hm = parseEventTime(e.time);
+    if (hm) {
+      const [h, m] = hm.split(':').map(Number);
+      L.push(fold(`DTSTART:${ymd(e.date)}T${pad(h)}${pad(m)}00`));
+      const total = h * 60 + m + opts.durationMinutes;
+      const end = new Date(Date.UTC(e.date.getUTCFullYear(), e.date.getUTCMonth(), e.date.getUTCDate()) + total * 60000);
+      L.push(fold(`DTEND:${ymd(end)}T${pad(end.getUTCHours())}${pad(end.getUTCMinutes())}00`));
+    } else {
+      L.push(fold(`DTSTART;VALUE=DATE:${ymd(e.date)}`));
+    }
+    L.push(fold(`SUMMARY:${icsEscape(e.title)}`));
+    if (e.venue) {
+      const loc = e.venue.address ? `${e.venue.name}, ${e.venue.address}` : e.venue.name;
+      L.push(fold(`LOCATION:${icsEscape(loc)}`));
+    }
+    let desc = (e.description ?? '').trim();
+    if (e.checkin) desc = `${desc}\n${e.checkin}`;
+    desc = `${desc}\n${e.permalink}`;
+    L.push(fold(`DESCRIPTION:${icsEscape(desc)}`));
+    L.push(fold(`URL:${e.permalink}`));
+    L.push(fold(`STATUS:${e.cancelled ? 'CANCELLED' : 'CONFIRMED'}`));
+    L.push(fold('END:VEVENT'));
+  }
+  L.push(fold('END:VCALENDAR'));
+  return L.join('');
+}

package/src/lib/inline-md.ts

@@ -0,0 +1,21 @@
+/** Minimal inline-markdown renderer for short, author-controlled config
+ *  strings (e.g. the notice banner, §5). Parity with Hugo's inline
+ *  `.RenderString`: supports links, bold, emphasis, and inline code, and
+ *  HTML-escapes everything else. Not a full Markdown parser; block syntax
+ *  (headings, lists, images) is intentionally out of scope. */
+const escapeHtml = (s: string): string =>
+  s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+
+export function inlineMarkdown(src: string): string {
+  let s = escapeHtml(src);
+  // [label](http(s)://… | /path) — only http(s) and root-relative targets
+  s = s.replace(
+    /\[([^\]]+)\]\((https?:\/\/[^\s)]+|\/[^\s)]*)\)/g,
+    (_m, label, href) =>
+      `<a href="${href}"${href.startsWith('/') ? '' : ' rel="noopener" target="_blank"'}>${label}</a>`,
+  );
+  s = s.replace(/\*\*([^*]+)\*\*/g, '<strong>$1</strong>');
+  s = s.replace(/(^|[^*])\*([^*]+)\*/g, '$1<em>$2</em>');
+  s = s.replace(/`([^`]+)`/g, '<code>$1</code>');
+  return s;
+}

package/src/lib/talks.ts

@@ -0,0 +1,87 @@
+/** §3 talk archive helpers, shared by the event page, the event row, and the
+ *  /talks/ index. A "talk" is either an entry in an event's talks[] array or,
+ *  for single-talk meetups, the event itself when it carries event-level
+ *  recording/slides. When talks[] is present it wins; event-level
+ *  recording/slides are ignored (not merged), matching the Hugo side. */
+import type { CollectionEntry } from 'astro:content';
+
+type EventData = CollectionEntry<'events'>['data'];
+
+export interface Talk {
+  title: string;
+  speakerSlug?: string; // resolved speaker-profile slug, for linking
+  speakerName?: string; // display name (profile title, or the free-text speaker)
+  recording?: string;
+  slides?: string;
+}
+
+export interface TalkRow extends Talk {
+  eventId: string;
+  eventTitle: string;
+  date: Date;
+  tags: string[];
+}
+
+/** True if an event has any recording (event-level or in a talk), for the
+ *  browsing cue on past-event rows. */
+export function eventHasRecording(d: EventData): boolean {
+  const talks = (d as { talks?: { recording?: string }[] }).talks;
+  if (talks?.length) return talks.some((t) => !!t.recording);
+  return !!(d as { recording?: string }).recording;
+}
+
+/** The talks for one event, normalized. speakers is the resolved collection so
+ *  a talk's speaker slug (or the event's first speaker, in the simple case)
+ *  becomes a linkable name; an unresolved slug warns and renders name-less. */
+export function eventTalks(
+  d: EventData,
+  speakers: CollectionEntry<'speakers'>[],
+  eventId: string,
+): Talk[] {
+  const nameOf = (slug?: string): string | undefined => {
+    if (!slug) return undefined;
+    const found = speakers.find((s) => s.id === slug);
+    if (!found) console.warn(`events/${eventId}: talk speaker "${slug}" matches no speaker page`);
+    return found?.data.title;
+  };
+  const anyD = d as EventData & {
+    talks?: Talk[]; recording?: string; slides?: string;
+  };
+  if (anyD.talks?.length) {
+    return anyD.talks.map((t) => ({
+      title: t.title,
+      speakerSlug: nameOf(t.speaker) ? t.speaker : undefined,
+      speakerName: nameOf(t.speaker),
+      recording: t.recording,
+      slides: t.slides,
+    }));
+  }
+  if (anyD.recording || anyD.slides) {
+    const slug = d.speakers[0];
+    const name = nameOf(slug) ?? d.speaker;
+    return [{
+      title: d.title,
+      speakerSlug: nameOf(slug) ? slug : undefined,
+      speakerName: name,
+      recording: anyD.recording,
+      slides: anyD.slides,
+    }];
+  }
+  return [];
+}
+
+/** Every talk across the given events, newest event first, for the /talks/
+ *  index. Each row carries its parent event's link, date, and tags (the tags
+ *  drive the shared blog-filter.js tag filter). */
+export function collectTalks(
+  events: CollectionEntry<'events'>[],
+  speakers: CollectionEntry<'speakers'>[],
+): TalkRow[] {
+  const rows: TalkRow[] = [];
+  for (const e of [...events].sort((a, b) => +b.data.date - +a.data.date)) {
+    for (const t of eventTalks(e.data, speakers, e.id)) {
+      rows.push({ ...t, eventId: e.id, eventTitle: e.data.title, date: e.data.date, tags: e.data.tags });
+    }
+  }
+  return rows;
+}

package/src/pages/[...slug].astro

@@ -5,7 +5,7 @@ import { STRINGS } from 'popular:config';
 import { render } from 'astro:content';
 import { safeCollection } from '../lib/collections';
 import BaseLayout from '../layouts/BaseLayout.astro';
-import PageHero from '../components/PageHero.astro';
+import PageHero from 'popular:component/PageHero';
 
 export async function getStaticPaths() {
   const pages = await safeCollection('pages');

package/src/pages/authors/[slug].astro

@@ -3,9 +3,9 @@ import { STRINGS } from 'popular:config';
 import { render } from 'astro:content';
 import { safeCollection } from '../../lib/collections';
 import BaseLayout from '../../layouts/BaseLayout.astro';
-import PageHero from '../../components/PageHero.astro';
-import AuthorBox from '../../components/AuthorBox.astro';
-import PostCard from '../../components/PostCard.astro';
+import PageHero from 'popular:component/PageHero';
+import AuthorBox from 'popular:component/AuthorBox';
+import PostCard from 'popular:component/PostCard';
 
 export async function getStaticPaths() {
   const authors = await safeCollection('authors');
@@ -20,7 +20,7 @@ const posts = (await safeCollection('blog'))
 ---
 
 <BaseLayout title={entry.data.title} description={entry.data.bio}>
-  <PageHero eyebrow={STRINGS.eyebrowAuthor} title={entry.data.title} lead={entry.data.bio} />
+  <PageHero eyebrow={STRINGS.eyebrowAuthor} title={entry.data.title} />
   <section class="g-bg-white g-section">
     <div class="g-container">
       <div class="g-article" style="margin-bottom:var(--space-5)">

package/src/pages/blog/[...page].astro

@@ -1,8 +1,8 @@
 ---
 import { safeCollection } from '../../lib/collections';
 import BaseLayout from '../../layouts/BaseLayout.astro';
-import PageHero from '../../components/PageHero.astro';
-import PostCard from '../../components/PostCard.astro';
+import PageHero from 'popular:component/PageHero';
+import PostCard from 'popular:component/PostCard';
 import Pagination from '../../components/Pagination.astro';
 import { SECTIONS, STRINGS, PAGINATION } from 'popular:config';
 

package/src/pages/blog/[slug].astro

@@ -2,7 +2,7 @@
 import { render } from 'astro:content';
 import { safeCollection } from '../../lib/collections';
 import BaseLayout from '../../layouts/BaseLayout.astro';
-import AuthorBox from '../../components/AuthorBox.astro';
+import AuthorBox from 'popular:component/AuthorBox';
 import { SUPPORT, SITE, STRINGS, SECTIONS_MAP } from 'popular:config';
 import { buildBlogPostingLd, jsonld } from '../../lib/jsonld';
 import { tagSlug } from '../../lib/slugs';

package/src/pages/events/[...page].astro

@@ -1,9 +1,10 @@
 ---
 import { safeCollection } from '../../lib/collections';
 import BaseLayout from '../../layouts/BaseLayout.astro';
-import PageHero from '../../components/PageHero.astro';
-import EventRow from '../../components/EventRow.astro';
+import PageHero from 'popular:component/PageHero';
+import EventRow from 'popular:component/EventRow';
 import Pagination from '../../components/Pagination.astro';
+import EventsEmpty from '../../components/EventsEmpty.astro';
 import { SECTIONS, STRINGS, PAGINATION } from 'popular:config';
 
 /* One route serves /events/ and /events/page/N/, matching the Hugo theme's
@@ -52,6 +53,7 @@ const groupByYear = (events: EventEntry[]) => {
         <span class="g-eyebrow">{STRINGS.comingUp}</span>
         <h2>{STRINGS.upcomingEvents}</h2>
         <p class="g-lead">{STRINGS.upcomingLead}</p>
+        <div class="g-row" style="margin-top:var(--space-3)"><a class="g-btn g-btn--outline g-btn--sm" href="/events/calendar.ics"><i class="fa-solid fa-calendar-plus" aria-hidden="true"></i> {STRINGS.subscribeCalendar}</a></div>
       </div>
       <div class="g-stack" style="margin-top:var(--space-4);gap:var(--space-3)">
         {groupByYear(upcoming).map((group) => (
@@ -60,9 +62,7 @@ const groupByYear = (events: EventEntry[]) => {
             {group.events.map((e) => <EventRow event={e} />)}
           </>
         ))}
-        {upcoming.length === 0 && (
-          <p class="g-lead">{STRINGS.noUpcomingEvents}</p>
-        )}
+        {upcoming.length === 0 && <EventsEmpty />}
       </div>
     </div>
   </section>

package/src/pages/events/[slug].astro

@@ -4,7 +4,8 @@ import { buildEventLd, jsonld } from '../../lib/eventld';
 import { render } from 'astro:content';
 import { safeCollection } from '../../lib/collections';
 import BaseLayout from '../../layouts/BaseLayout.astro';
-import AuthorBox from '../../components/AuthorBox.astro';
+import AuthorBox from 'popular:component/AuthorBox';
+import { eventTalks } from '../../lib/talks';
 
 export async function getStaticPaths() {
   const events = (await safeCollection('events')).filter((e) => !e.data.draft);
@@ -30,6 +31,11 @@ const speakerEntries = d.speakers.map((slug) => {
   return entry;
 });
 
+/* §3 talks: multi-talk events render a Talks section; single-talk events
+   render recording/slides links inline in the meta block. */
+const talks = eventTalks(d, allSpeakers, event.id);
+const hasTalksArray = !!(d.talks && d.talks.length > 0);
+
 /* schema.org/Event JSON-LD (see lib/eventld; contract in PARITY.md). */
 const siteUrl = new URL('/', Astro.site ?? Astro.url).href;
 const permalink = new URL(`/events/${event.id}/`, Astro.site ?? Astro.url).href;
@@ -74,7 +80,11 @@ const eventLd = jsonld(buildEventLd({
         <span><i class="fa-solid fa-location-dot" aria-hidden="true"></i> {venuePage
           ? <><a href={`/venues/${venuePage.id}/`}>{venuePage.data.title}</a>{venuePage.data.address && ` · ${venuePage.data.address}`}</>
           : <>{d.venue ?? STRINGS.venueTba}{d.address && ` · ${d.address}`}</>}</span>
+        {venuePage?.data.wheelchair && <span><span class="g-badge g-badge--success g-badge--soft"><i class="fa-solid fa-wheelchair" aria-hidden="true"></i> {STRINGS.wheelchairAccessible}</span></span>}
+        {venuePage && (venuePage.data.transit || venuePage.data.parking || venuePage.data.access) && <span><a href={`/venues/${venuePage.id}/`}>{STRINGS.gettingThere}</a></span>}
         {d.speaker && <span><i class="fa-solid fa-microphone-lines" aria-hidden="true"></i> {d.speaker}</span>}
+        {!hasTalksArray && d.recording && <span><a href={d.recording} rel="noopener" target="_blank"><i class="fa-solid fa-circle-play" aria-hidden="true"></i> {STRINGS.watchRecording}</a></span>}
+        {!hasTalksArray && d.slides && <span><a href={d.slides} rel="noopener" target="_blank"><i class="fa-solid fa-file-lines" aria-hidden="true"></i> {STRINGS.viewSlides}</a></span>}
       </div>
 
       {(d.checkin || venueNotes) && (
@@ -96,6 +106,28 @@ const eventLd = jsonld(buildEventLd({
         </>
       )}
 
+      {hasTalksArray && (
+        <>
+          <h2 style="font-size:var(--text-xl);margin:var(--space-5) 0 1rem">{STRINGS.talks}</h2>
+          <div class="g-stack" style="gap:var(--space-3)">
+            {talks.map((t) => (
+              <div class="g-talk">
+                <div class="g-talk__title">{t.title}</div>
+                {t.speakerName && (
+                  <div class="g-talk__by"><i class="fa-solid fa-microphone-lines" aria-hidden="true"></i> {t.speakerSlug ? <a href={`/speakers/${t.speakerSlug}/`}>{t.speakerName}</a> : t.speakerName}</div>
+                )}
+                {(t.recording || t.slides) && (
+                  <div class="g-row" style="gap:var(--space-2)">
+                    {t.recording && <a class="g-btn g-btn--sm g-btn--outline" href={t.recording} rel="noopener" target="_blank"><i class="fa-solid fa-circle-play" aria-hidden="true"></i> {STRINGS.watchRecording}</a>}
+                    {t.slides && <a class="g-btn g-btn--sm g-btn--ghost" href={t.slides} rel="noopener" target="_blank"><i class="fa-solid fa-file-lines" aria-hidden="true"></i> {STRINGS.viewSlides}</a>}
+                  </div>
+                )}
+              </div>
+            ))}
+          </div>
+        </>
+      )}
+
       {d.rsvp && (
         <div class="g-row" style="margin-top:var(--space-4)">
           <a class="g-btn g-btn--primary g-btn--lg" href={d.rsvp}><i class="fa-solid fa-calendar" aria-hidden="true"></i> {STRINGS.rsvpExternal}</a>

package/src/pages/events/calendar.ics.ts

@@ -0,0 +1,34 @@
+import type { APIRoute } from 'astro';
+import { getCollection } from 'astro:content';
+import { buildIcs } from '../../lib/ical';
+import { SITE } from 'popular:config';
+
+/* iCalendar feed: upcoming events plus the last 90 days. Mirrors the Hugo
+   events/list.calendar.ics template. */
+export const GET: APIRoute = async ({ site }) => {
+  const base = site ?? new URL('https://example.com');
+  const cutoff = Date.now() - 90 * 24 * 60 * 60 * 1000;
+  const events = (await getCollection('events'))
+    .filter((e) => !e.data.draft && +e.data.date >= cutoff)
+    .sort((a, b) => +a.data.date - +b.data.date);
+  const venues = await getCollection('venues');
+  const duration = (SITE as Record<string, any>).events?.defaultDurationMinutes ?? 120;
+  const dtstamp = new Date().toISOString().replace(/[-:]/g, '').replace(/\.\d{3}/, '');
+  const body = buildIcs(
+    events.map((e) => {
+      const v = e.data.venueRef ? venues.find((x) => x.id === e.data.venueRef) : undefined;
+      return {
+        title: e.data.title,
+        date: e.data.date,
+        time: e.data.time,
+        description: (e.data.description ?? '').trim(),
+        checkin: e.data.checkin,
+        cancelled: e.data.cancelled,
+        venue: v ? { name: v.data.title, address: v.data.address } : (e.data.venue ? { name: e.data.venue } : undefined),
+        permalink: new URL(`/events/${e.id}/`, base).href,
+      };
+    }),
+    { siteTitle: SITE.title, dtstamp, durationMinutes: duration },
+  );
+  return new Response(body, { headers: { 'Content-Type': 'text/calendar; charset=utf-8' } });
+};

package/src/pages/index.astro

@@ -2,8 +2,9 @@
 import { safeCollection } from '../lib/collections';
 import { formatStat, countSectionsIn } from '../lib/stats';
 import BaseLayout from '../layouts/BaseLayout.astro';
-import PostCard from '../components/PostCard.astro';
-import OrganizerCard from '../components/OrganizerCard.astro';
+import PostCard from 'popular:component/PostCard';
+import OrganizerCard from 'popular:component/OrganizerCard';
+import EventsEmpty from '../components/EventsEmpty.astro';
 import { HOME, SITE, STRINGS, SECTIONS_MAP, SOCIAL } from 'popular:config';
 import { buildOrgLd, jsonld } from '../lib/jsonld';
 
@@ -26,6 +27,7 @@ const nextVenue = next?.data.venueRef ? (await safeCollection('venues')).find((v
 const organizers = (await safeCollection(SECTIONS_MAP.team)).sort((a, b) => a.data.weight - b.data.weight);
 
 const h = HOME;
+const chat = (SITE as Record<string, any>).community?.chat;
 const orgLd = jsonld(buildOrgLd({
   name: SITE.title,
   url: new URL('/', Astro.site ?? Astro.url).href,
@@ -44,13 +46,18 @@ const orgLd = jsonld(buildOrgLd({
           {h.hero.eyebrow && <span class="g-eyebrow">{h.hero.eyebrow}</span>}
           <h1>{h.hero.title}</h1>
           {h.hero.lead && <p class="g-hero__lead">{h.hero.lead}</p>}
-          {h.hero.ctas && (
+          {(h.hero.ctas || chat) && (
             <div class="g-row">
-              {h.hero.ctas.map((c) => (
+              {(h.hero.ctas ?? []).map((c) => (
                 <a class={`g-btn g-btn--lg g-btn--${c.variant ?? 'primary'}`} href={c.url}>
                   {'icon' in c && c.icon && <i class={c.icon} aria-hidden="true"></i>}{c.label}
                 </a>
               ))}
+              {chat && (
+                <a class="g-btn g-btn--lg g-btn--secondary" href={chat.url} {...(chat.url.startsWith('/') ? {} : { rel: 'noopener', target: '_blank' })}>
+                  <i class="fa-solid fa-comments" aria-hidden="true"></i> {chat.label ?? STRINGS.joinChat}
+                </a>
+              )}
             </div>
           )}
         </div>
@@ -115,6 +122,12 @@ const orgLd = jsonld(buildOrgLd({
     </section>
   )}
 
+  {events.length > 0 && !next && (
+    <section class="g-bg-wash-soft g-section">
+      <div class="g-container"><EventsEmpty /></div>
+    </section>
+  )}
+
   {posts.length > 0 && (
     <section class="g-bg-white g-section">
       <div class="g-container">

package/src/pages/llms.txt.ts

@@ -0,0 +1,46 @@
+import type { APIRoute } from 'astro';
+import { getCollection } from 'astro:content';
+import { SITE } from 'popular:config';
+
+/* §8 llms.txt: a build-time plain-text summary for AI agents. Names the next
+   upcoming event (regenerated every build so it stays true), how to join, and
+   links to the key pages and the calendar feed. Mirrors Hugo's
+   layouts/index.llms.txt. Always generated (SEO/discovery plumbing, like
+   robots.txt). */
+export const GET: APIRoute = async ({ site }) => {
+  const base = site ?? new URL('https://example.com');
+  const abs = (p: string) => new URL(p, base).href;
+  const now = Date.now();
+
+  const events = (await getCollection('events'))
+    .filter((e) => !e.data.draft)
+    .sort((a, b) => +a.data.date - +b.data.date);
+  const next = events.find((e) => +e.data.date >= now);
+
+  const pageIds = new Set((await getCollection('pages')).map((p) => p.id));
+  const chat = (SITE as Record<string, any>).community?.chat as { url: string; label?: string } | undefined;
+  const talksOn = (SITE as Record<string, any>).talks === true;
+  const fmt = (d: Date) =>
+    d.toLocaleDateString(SITE.locale, { weekday: 'long', month: 'long', day: 'numeric', year: 'numeric' });
+
+  const lines: string[] = [`# ${SITE.title}`, ''];
+  if (SITE.description) lines.push(SITE.description, '');
+  lines.push(
+    next
+      ? `Next event: ${next.data.title} on ${fmt(next.data.date)}${next.data.time ? `, ${next.data.time}` : ''} (${abs(`/events/${next.id}/`)})`
+      : 'No upcoming events are scheduled right now.',
+    '',
+  );
+  if (chat) lines.push(`Join the community chat: ${chat.url}`, '');
+  lines.push('## Links');
+  if (pageIds.has('start')) lines.push(`Start here (newcomers): ${abs('/start/')}`);
+  if (pageIds.has('about')) lines.push(`About and FAQ: ${abs('/about/')}`);
+  lines.push(`Events: ${abs('/events/')}`);
+  lines.push(`Calendar feed (iCalendar): ${abs('/events/calendar.ics')}`);
+  if (talksOn) lines.push(`Talk archive: ${abs('/talks/')}`);
+  lines.push('', 'Built with the Popular theme.');
+
+  return new Response(lines.join('\n') + '\n', {
+    headers: { 'Content-Type': 'text/plain; charset=utf-8' },
+  });
+};

package/src/pages/organizers/[...page].astro

@@ -1,8 +1,8 @@
 ---
 import { safeCollection } from '../../lib/collections';
 import BaseLayout from '../../layouts/BaseLayout.astro';
-import PageHero from '../../components/PageHero.astro';
-import OrganizerCard from '../../components/OrganizerCard.astro';
+import PageHero from 'popular:component/PageHero';
+import OrganizerCard from 'popular:component/OrganizerCard';
 import Pagination from '../../components/Pagination.astro';
 import { SECTIONS, PAGINATION } from 'popular:config';
 

package/src/pages/organizers/[slug].astro

@@ -1,10 +1,10 @@
 ---
-import { STRINGS } from 'popular:config';
+import { STRINGS, SECTIONS_MAP } from 'popular:config';
 import { render } from 'astro:content';
 import { safeCollection } from '../../lib/collections';
 import BaseLayout from '../../layouts/BaseLayout.astro';
-import PageHero from '../../components/PageHero.astro';
-import AuthorBox from '../../components/AuthorBox.astro';
+import PageHero from 'popular:component/PageHero';
+import AuthorBox from 'popular:component/AuthorBox';
 
 export async function getStaticPaths() {
   const organizers = await safeCollection('organizers');
@@ -17,7 +17,7 @@ const { Content } = await render(entry);
 ---
 
 <BaseLayout title={d.title} description={d.description}>
-  <PageHero eyebrow={d.role ?? STRINGS.eyebrowOrganizer} title={d.title} lead={d.description} />
+  <PageHero eyebrow={d.role ?? STRINGS.eyebrowOrganizer} backHref={`/${SECTIONS_MAP.team}/`} backLabel={STRINGS.allOrganizers} title={d.title} />
   <section class="g-bg-white g-section">
     <div class="g-container">
       <div class="g-article">

package/src/pages/speakers/[slug].astro

@@ -3,9 +3,9 @@ import { STRINGS } from 'popular:config';
 import { render } from 'astro:content';
 import { safeCollection } from '../../lib/collections';
 import BaseLayout from '../../layouts/BaseLayout.astro';
-import PageHero from '../../components/PageHero.astro';
-import AuthorBox from '../../components/AuthorBox.astro';
-import EventRow from '../../components/EventRow.astro';
+import PageHero from 'popular:component/PageHero';
+import AuthorBox from 'popular:component/AuthorBox';
+import EventRow from 'popular:component/EventRow';
 
 export async function getStaticPaths() {
   const speakers = await safeCollection('speakers');
@@ -20,7 +20,7 @@ const events = (await safeCollection('events'))
 ---
 
 <BaseLayout title={entry.data.title} description={entry.data.bio}>
-  <PageHero eyebrow={STRINGS.eyebrowSpeaker} title={entry.data.title} lead={entry.data.bio} />
+  <PageHero eyebrow={STRINGS.eyebrowSpeaker} backHref="/speakers/" backLabel={STRINGS.allSpeakers} title={entry.data.title} />
   <section class="g-bg-white g-section">
     <div class="g-container">
       <div class="g-article" style="margin-bottom:var(--space-5)">

package/src/pages/speakers/index.astro

@@ -0,0 +1,26 @@
+---
+/** Speakers list, mirroring Hugo's layouts/speakers/list.html: every speaker
+ *  rendered as an AuthorBox, sorted by name. Fixes the "All speakers" backlink
+ *  on speaker detail pages, which previously had no list page to point to. */
+import { safeCollection } from '../../lib/collections';
+import BaseLayout from '../../layouts/BaseLayout.astro';
+import PageHero from '../../components/PageHero.astro';
+import AuthorBox from 'popular:component/AuthorBox';
+import SpeakerInvite from '../../components/SpeakerInvite.astro';
+import { SECTIONS } from 'popular:config';
+
+const speakers = (await safeCollection('speakers')).sort((a, b) => a.data.title.localeCompare(b.data.title));
+const sec = SECTIONS.speakers;
+---
+
+<BaseLayout title={sec.title} description={sec.lead}>
+  <PageHero eyebrow={sec.eyebrow} title={sec.title} lead={sec.lead} />
+  <section class="g-bg-white g-section">
+    <div class="g-container">
+      <div class="g-stack" style="max-width:52rem;gap:var(--space-3)">
+        {speakers.map((s) => <AuthorBox entry={s} base="/speakers/" />)}
+        <SpeakerInvite />
+      </div>
+    </div>
+  </section>
+</BaseLayout>

package/src/pages/tags/[tag]/[...page].astro

@@ -3,8 +3,8 @@ import { SITE, STRINGS, PAGINATION } from 'popular:config';
 import { tagSlug } from '../../../lib/slugs';
 import { safeCollection } from '../../../lib/collections';
 import BaseLayout from '../../../layouts/BaseLayout.astro';
-import PageHero from '../../../components/PageHero.astro';
-import PostCard from '../../../components/PostCard.astro';
+import PageHero from 'popular:component/PageHero';
+import PostCard from 'popular:component/PostCard';
 import Pagination from '../../../components/Pagination.astro';
 
 /* One route serves /tags/<tag>/ and /tags/<tag>/page/N/, matching the Hugo

package/src/pages/talks/[...page].astro

@@ -0,0 +1,58 @@
+---
+/** §3 talk archive index. Opt-in: builds only when SITE.talks is true (the
+ *  Astro counterpart of Hugo's "create content/talks/_index.md to enable"),
+ *  so sites without recordings do not grow an empty page. Aggregates every
+ *  talk across events, newest first, filterable by the parent event's tags
+ *  via the shared blog-filter.js (same [data-filterbar] / [data-tags] markup
+ *  as the blog list). */
+import { SITE, STRINGS } from 'popular:config';
+import { safeCollection } from '../../lib/collections';
+import { collectTalks } from '../../lib/talks';
+import BaseLayout from '../../layouts/BaseLayout.astro';
+import PageHero from 'popular:component/PageHero';
+
+export async function getStaticPaths() {
+  if ((SITE as Record<string, any>).talks !== true) return [];
+  const events = (await safeCollection('events')).filter((e) => !e.data.draft);
+  const speakers = await safeCollection('speakers');
+  return [{ params: { page: undefined }, props: { talks: collectTalks(events, speakers) } }];
+}
+
+const { talks } = Astro.props;
+const tags = [...new Set(talks.flatMap((t) => t.tags))].sort();
+const fmt = (d: Date) => d.toLocaleDateString(SITE.locale, { month: 'short', day: 'numeric', year: 'numeric' });
+---
+
+<BaseLayout title={STRINGS.talks} description={STRINGS.talksLead}>
+  <PageHero eyebrow={STRINGS.talks} title={STRINGS.talks} lead={STRINGS.talksLead} />
+  <section class="g-bg-white g-section">
+    <div class="g-container">
+      <div class="g-row" data-filterbar style="margin-bottom:var(--space-5)">
+        {tags.length > 0 && (
+          <>
+            <span style="font-size:var(--text-sm);color:var(--text-muted)">{STRINGS.filterLabel}</span>
+            <button class="g-filter is-active" data-filter="*">{STRINGS.filterAll}</button>
+            {tags.map((t) => <button class="g-filter" data-filter={t}>#{t}</button>)}
+          </>
+        )}
+      </div>
+      <div class="g-stack" style="gap:var(--space-3)">
+        {talks.map((t) => (
+          <div class="g-talk" data-tags={t.tags.join(',')}>
+            <div class="g-talk__title">{t.title}</div>
+            {t.speakerName && (
+              <div class="g-talk__by"><i class="fa-solid fa-microphone-lines" aria-hidden="true"></i> {t.speakerSlug ? <a href={`/speakers/${t.speakerSlug}/`}>{t.speakerName}</a> : t.speakerName}</div>
+            )}
+            <div class="g-talk__event"><i class="fa-solid fa-calendar-day" aria-hidden="true"></i> <a href={`/events/${t.eventId}/`}>{t.eventTitle}</a> · {fmt(t.date)}</div>
+            {(t.recording || t.slides) && (
+              <div class="g-row" style="gap:var(--space-2)">
+                {t.recording && <a class="g-btn g-btn--sm g-btn--outline" href={t.recording} rel="noopener" target="_blank"><i class="fa-solid fa-circle-play" aria-hidden="true"></i> {STRINGS.watchRecording}</a>}
+                {t.slides && <a class="g-btn g-btn--sm g-btn--ghost" href={t.slides} rel="noopener" target="_blank"><i class="fa-solid fa-file-lines" aria-hidden="true"></i> {STRINGS.viewSlides}</a>}
+              </div>
+            )}
+          </div>
+        ))}
+      </div>
+    </div>
+  </section>
+</BaseLayout>

package/src/pages/venues/[slug].astro

@@ -20,7 +20,7 @@ const events = (await safeCollection('events'))
 ---
 
 <BaseLayout title={d.title} description={d.address}>
-  <PageHero eyebrow={STRINGS.eyebrowVenue} title={d.title} lead={d.address} />
+  <PageHero eyebrow={STRINGS.eyebrowVenue} backHref="/venues/" backLabel={STRINGS.allVenues} title={d.title} lead={d.address} />
   <section class="g-bg-white g-section">
     <div class="g-container">
       <div class="g-article" style="margin-bottom:var(--space-5)">
@@ -36,6 +36,17 @@ const events = (await safeCollection('events'))
             {d.accessibility && <div class="g-callout__body"><i class="fa-solid fa-universal-access" aria-hidden="true"></i> {d.accessibility}</div>}
           </div>
         )}
+        {(d.wheelchair || d.transit || d.parking || d.access) && (
+          <>
+            <div class="g-section-head" style="margin-top:var(--space-4)"><span class="g-eyebrow">{STRINGS.eyebrowVenue}</span><h2 style="font-size:var(--text-xl)">{STRINGS.gettingThere}</h2></div>
+            {d.wheelchair && <p><span class="g-badge g-badge--success g-badge--soft"><i class="fa-solid fa-wheelchair" aria-hidden="true"></i> {STRINGS.wheelchairAccessible}</span></p>}
+            <div class="g-meta-line" style="flex-direction:column;align-items:flex-start;gap:.4rem">
+              {d.transit && <span><i class="fa-solid fa-train-subway" aria-hidden="true"></i> <strong>{STRINGS.transit}:</strong> {d.transit}</span>}
+              {d.parking && <span><i class="fa-solid fa-square-parking" aria-hidden="true"></i> <strong>{STRINGS.parking}:</strong> {d.parking}</span>}
+            </div>
+            {d.access && <div class="g-prose" style="margin-top:var(--space-3)"><p>{d.access}</p></div>}
+          </>
+        )}
         <div class="g-prose" style="margin-top:var(--space-4)"><Content /></div>
       </div>
       {events.length > 0 && (

package/src/pages/venues/index.astro

@@ -0,0 +1,33 @@
+---
+/** Venues list, mirroring Hugo's layouts/venues/list.html: a card grid of every
+ *  venue, sorted by name. Fixes the "All venues" backlink on venue detail pages,
+ *  which previously had no list page to point to. */
+import { safeCollection } from '../../lib/collections';
+import BaseLayout from '../../layouts/BaseLayout.astro';
+import PageHero from '../../components/PageHero.astro';
+import { SECTIONS } from 'popular:config';
+
+const venues = (await safeCollection('venues')).sort((a, b) => a.data.title.localeCompare(b.data.title));
+const sec = SECTIONS.venues;
+---
+
+<BaseLayout title={sec.title} description={sec.lead}>
+  <PageHero eyebrow={sec.eyebrow} title={sec.title} lead={sec.lead} />
+  <section class="g-bg-white g-section">
+    <div class="g-container">
+      <div class="g-grid-3">
+        {venues.map((v) => (
+          <article class="g-card">
+            {v.data.photo && (
+              <a href={`/venues/${v.id}/`} class="g-card__media"><img src={v.data.photo} alt={v.data.title} loading="lazy" decoding="async" /></a>
+            )}
+            <div class="g-card__body">
+              <h3 class="g-card__title"><a href={`/venues/${v.id}/`}>{v.data.title}</a></h3>
+              {v.data.address && <div class="g-card__text"><i class="fa-solid fa-location-dot" aria-hidden="true"></i> {v.data.address}</div>}
+            </div>
+          </article>
+        ))}
+      </div>
+    </div>
+  </section>
+</BaseLayout>

package/src/styles/components.css

@@ -320,3 +320,32 @@ pre:hover .g-copy, .g-copy:focus-visible { opacity: 1; }
   .g-nav__toggle { display: block; }
   .g-nav__cta { display: none; }
 }
+
+/* Notice banner (§5): site-wide static announcement above the header. */
+.g-notice { background: var(--surface-wash); border-bottom: var(--border-width) solid var(--border-subtle); color: var(--text-body); font-size: var(--text-sm); }
+.g-notice__inner { display: flex; gap: 0.4rem 0.7rem; align-items: center; justify-content: center; flex-wrap: wrap; padding: 0.6rem var(--space-4); text-align: center; }
+.g-notice__inner > i { color: var(--text-link); }
+.g-notice a { color: var(--text-link); font-weight: var(--weight-medium); text-decoration: underline; }
+
+/* Designed empty state (§5): zero upcoming events on home + events list. */
+.g-empty { display: flex; flex-direction: column; align-items: center; gap: var(--space-3); text-align: center; padding: var(--space-5) 0; }
+.g-empty .g-lead { margin: 0; max-width: 32rem; }
+
+/* Talk archive (§3): a talk entry on the event page and the /talks/ index. */
+.g-talk { display: flex; flex-direction: column; gap: 0.4rem; padding: var(--space-3); border: var(--border-width) solid var(--border-subtle); border-radius: var(--radius-lg); background: var(--surface-card); }
+.g-talk__title { font-weight: var(--weight-medium); }
+.g-talk__by { font-size: var(--text-sm); color: var(--text-muted); }
+.g-talk__by a { color: var(--text-link); }
+.g-talk__event { font-size: var(--text-sm); color: var(--text-muted); }
+.g-talk__event a { color: var(--text-link); }
+
+/* Photo gallery + pullquote (§6). No JS, no lightbox: each photo links to its
+   full-size image (native <a>, the deliberate non-feature). */
+.g-gallery { display: grid; grid-template-columns: repeat(auto-fill, minmax(180px, 1fr)); gap: var(--space-3); margin: var(--space-4) 0; }
+.g-gallery__item { margin: 0; }
+.g-gallery__item img { width: 100%; aspect-ratio: 4 / 3; object-fit: cover; border-radius: var(--radius-lg); display: block; }
+.g-gallery__item figcaption { font-size: var(--text-sm); color: var(--text-muted); margin-top: 0.35rem; }
+.g-pullquote { margin: var(--space-4) 0; padding-left: var(--space-4); border-left: 3px solid var(--text-link); }
+.g-pullquote blockquote { margin: 0; font-size: var(--text-lg); font-style: italic; }
+.g-pullquote figcaption { margin-top: 0.5rem; font-size: var(--text-sm); color: var(--text-muted); font-style: normal; }
+.g-pullquote figcaption::before { content: "\2014 \00a0"; }