create-popular-site 0.10.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mariatta
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,57 @@
+# create-popular-site
+
+Start a community site on [Popular](https://popular.mariatta.ca/), a warm,
+community-first Astro theme for meetups, user groups and small events.
+
+```bash
+npm create popular-site@latest
+```
+
+or, skipping the questions:
+
+```bash
+npm create popular-site@latest my-community -- --template aquarium --site https://my.community --yes
+```
+
+## Templates
+
+| Template | What it is |
+|---|---|
+| `starter` | "Your Community": a neutral skeleton, ready to fill in. The default. |
+| `aquarium` | Rocky Cove Aquarium Club: a fuller meetup example |
+| `foodie` | Lucky Town Foodie Club: a fuller meetup example |
+| `kdrama` | KDrama Fan Club: a fan community with a photo gallery |
+| `superfan` | Truly Madly Riley: a personal site, no organizers |
+
+All of them are fictional. The flavored ones are useful when you would rather
+edit something down than fill something in.
+
+## What you get
+
+A small project that **depends on** the theme rather than containing a copy of
+it:
+
+```
+popular.config.ts     your settings: name, nav, footer, brand, UI strings
+src/content/          your events, posts, organizers, speakers, venues, docs
+src/content.config.ts one line, adopting the theme's content model
+public/images/        your images
+astro.config.mjs      site + base, and the theme integration
+```
+
+Updating is `npm update astro-theme-popular`. You are not holding a copy of the
+theme, so there is nothing to re-merge, which is what makes a site survive
+being handed to the next organizer.
+
+## Options
+
+| Flag | Meaning |
+|---|---|
+| `-t`, `--template <name>` | one of the templates above (default `starter`) |
+| `--site <url>` | the URL the site will be served from. A project-page URL like `https://you.github.io/my-community/` is split into Astro's `site` and `base` for you. |
+| `-y`, `--yes` | accept defaults, ask nothing (also the behavior when stdin is not a TTY) |
+
+## Licence
+
+MIT. The theme, its demos and this scaffolder all ship from
+[Mariatta/astro-theme-popular](https://github.com/Mariatta/astro-theme-popular).

package/index.mjs

@@ -0,0 +1,224 @@
+#!/usr/bin/env node
+/**
+ * create-popular-site: start a community site on the Popular Astro theme.
+ *
+ *   npm create popular-site@latest
+ *   npm create popular-site@latest my-community -- --template aquarium
+ *   npm create popular-site@latest my-community -- --template starter --site https://my.community --yes
+ *
+ * Writes a small project that *depends on* astro-theme-popular rather than
+ * vendoring it, so the site updates with `npm update` instead of by diffing
+ * tags and re-copying files. That is the whole reason the theme was packaged
+ * (PACKAGING.md, "Why").
+ *
+ * Templates ship inside this package, collected from the repo's demo
+ * workspaces at pack time (scripts/collect-templates.mjs). `starter` is the
+ * neutral "Your Community" skeleton; the rest are the fictional demos, useful
+ * as a fuller example to edit down.
+ *
+ * Dependency-free on purpose: `npm create` runs this before the user has
+ * agreed to install anything, and the theme's other generator
+ * (scripts/setup.py) is stdlib-only for the same reason.
+ */
+import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { createInterface } from 'node:readline/promises';
+import { fileURLToPath } from 'node:url';
+import { stdin, stdout } from 'node:process';
+
+const HERE = resolve(dirname(fileURLToPath(import.meta.url)));
+const TEMPLATE_DIR = join(HERE, 'templates');
+const { version: VERSION } = JSON.parse(readFileSync(join(HERE, 'package.json'), 'utf8'));
+
+const TEMPLATES = {
+  starter: 'Your Community: a neutral skeleton, ready to fill in',
+  aquarium: 'Rocky Cove Aquarium Club: a fuller meetup example',
+  foodie: 'Lucky Town Foodie Club: a fuller meetup example',
+  kdrama: 'KDrama Fan Club: a fan community with a photo gallery',
+  superfan: 'Truly Madly Riley: a personal site, no organizers',
+};
+
+const die = (msg) => {
+  console.error(`create-popular-site: ${msg}`);
+  process.exit(1);
+};
+
+function parseArgs(argv) {
+  const out = { dir: undefined, template: undefined, site: undefined, yes: false };
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    if (arg === '--yes' || arg === '-y') out.yes = true;
+    else if (arg === '--template' || arg === '-t') out.template = argv[++i];
+    else if (arg === '--site') out.site = argv[++i];
+    else if (arg === '--help' || arg === '-h') out.help = true;
+    else if (arg.startsWith('-')) die(`unknown option ${arg}`);
+    else if (out.dir === undefined) out.dir = arg;
+    else die(`unexpected argument ${arg}`);
+  }
+  return out;
+}
+
+const HELP = `create-popular-site ${VERSION}
+
+  npm create popular-site@latest [directory] -- [options]
+
+Options:
+  -t, --template <name>   ${Object.keys(TEMPLATES).join(', ')} (default: starter)
+      --site <url>        the URL the site will be served from
+  -y, --yes               accept defaults, ask nothing
+  -h, --help              show this
+
+Docs: https://popular.mariatta.ca/docs/quick-start/?fw=astro
+`;
+
+/* A project name npm will accept: lowercase, no spaces, no leading dot. */
+const packageName = (dir) =>
+  dir.split('/').filter(Boolean).pop()
+    .toLowerCase()
+    .replace(/[^a-z0-9-~][^a-z0-9-._~]*/g, '-')
+    .replace(/^[-._]+|[-._]+$/g, '') || 'my-community';
+
+/* Astro wants the origin and the subpath separately, and a GitHub project page
+   needs both. Splitting one answer keeps the question count down; the same
+   split lives in scripts/setup.py (split_site_base). */
+function splitSiteBase(url) {
+  if (!url) return { site: 'https://example.com', base: '/' };
+  let parsed;
+  try {
+    parsed = new URL(url);
+  } catch {
+    die(`--site must be a full URL (got '${url}')`);
+  }
+  const path = parsed.pathname.replace(/\/+$/, '');
+  return { site: parsed.origin, base: path === '' ? '/' : path };
+}
+
+const astroConfig = ({ site, base }) => `import { defineConfig } from 'astro/config';
+import mdx from '@astrojs/mdx';
+import popular from 'astro-theme-popular';
+
+/* \`site\` is your origin and \`base\` is the path your site is served from.
+   A GitHub project page lives at you.github.io/my-community/, so its base is
+   '/my-community'; leave it '/' for a site at a domain root. Every link, image
+   and feed URL the theme writes follows both, markdown bodies included. */
+export default defineConfig({
+  site: '${site}',
+  base: '${base}',
+  integrations: [mdx(), popular()],
+});
+`;
+
+const packageJson = (name) => `${JSON.stringify({
+  name,
+  private: true,
+  type: 'module',
+  scripts: { dev: 'astro dev', build: 'astro build', preview: 'astro preview' },
+  dependencies: {
+    '@astrojs/mdx': '^7.0.2',
+    astro: '^7.0.6',
+    'astro-theme-popular': `^${VERSION}`,
+  },
+}, null, 2)}\n`;
+
+const CONTENT_CONFIG = `// The theme package owns the content model; this file just adopts it.
+// Add your own collections here if you need them.
+export { collections } from 'astro-theme-popular/schemas';
+`;
+
+const GITIGNORE = `dist/
+node_modules/
+.astro/
+.DS_Store
+`;
+
+const readme = (name, template) => `# ${name}
+
+A community site built with [Popular](https://popular.mariatta.ca/), started
+from the \`${template}\` template.
+
+\`\`\`bash
+npm install
+npm run dev
+\`\`\`
+
+- **Your settings** live in \`popular.config.ts\`: name, navigation, footer,
+  brand colours, and the UI strings.
+- **Your content** lives in \`src/content/\`: events, blog posts, organizers,
+  speakers, venues, and the handbook.
+- **Your images** live in \`public/images/\`.
+- **Updating the theme** is \`npm update astro-theme-popular\`. You are not
+  holding a copy of it, so there is nothing to re-merge.
+
+Docs: https://popular.mariatta.ca/docs/?fw=astro
+`;
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  if (args.help) {
+    stdout.write(HELP);
+    return;
+  }
+
+  const interactive = !args.yes && stdin.isTTY;
+  const rl = interactive ? createInterface({ input: stdin, output: stdout }) : null;
+  const ask = async (question, fallback) => {
+    if (!rl) return fallback;
+    const answer = (await rl.question(question)).trim();
+    return answer === '' ? fallback : answer;
+  };
+
+  try {
+    if (interactive) stdout.write(`\nPopular ${VERSION}: a community-first Astro theme.\n\n`);
+
+    const dir = args.dir ?? await ask('Directory [my-community]: ', 'my-community');
+
+    let template = args.template;
+    if (!template && interactive) {
+      stdout.write('\nTemplates:\n');
+      for (const [slug, blurb] of Object.entries(TEMPLATES)) {
+        stdout.write(`  ${slug.padEnd(9)} ${blurb}\n`);
+      }
+      template = await ask('\nTemplate [starter]: ', 'starter');
+    }
+    template ??= 'starter';
+    if (!Object.hasOwn(TEMPLATES, template)) {
+      die(`unknown template '${template}'. Choose one of: ${Object.keys(TEMPLATES).join(', ')}`);
+    }
+
+    const siteUrl = args.site ?? await ask(
+      '\nSite URL, if you know it [https://example.com]: ', 'https://example.com');
+
+    const target = resolve(process.cwd(), dir);
+    if (existsSync(target) && readdirSync(target).length > 0) {
+      die(`${dir} already exists and is not empty`);
+    }
+
+    const from = join(TEMPLATE_DIR, template);
+    if (!existsSync(from)) {
+      die(`this build of create-popular-site has no '${template}' template ` +
+          `(templates/ is populated at pack time; see scripts/collect-templates.mjs)`);
+    }
+
+    const name = packageName(dir);
+    mkdirSync(target, { recursive: true });
+    cpSync(from, target, { recursive: true });
+    mkdirSync(join(target, 'src'), { recursive: true });
+    writeFileSync(join(target, 'src', 'content.config.ts'), CONTENT_CONFIG);
+    writeFileSync(join(target, 'astro.config.mjs'), astroConfig(splitSiteBase(siteUrl)));
+    writeFileSync(join(target, 'package.json'), packageJson(name));
+    writeFileSync(join(target, '.gitignore'), GITIGNORE);
+    writeFileSync(join(target, 'README.md'), readme(name, template));
+
+    stdout.write(`\nCreated ${name} in ${dir} from the ${template} template.\n\n`);
+    stdout.write('Next:\n');
+    stdout.write(`  cd ${dir}\n`);
+    stdout.write('  npm install\n');
+    stdout.write('  npm run dev\n\n');
+    stdout.write('Then edit popular.config.ts to make it yours.\n');
+    stdout.write('Docs: https://popular.mariatta.ca/docs/quick-start/?fw=astro\n\n');
+  } finally {
+    rl?.close();
+  }
+}
+
+await main();

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "create-popular-site",
+  "version": "0.10.0",
+  "description": "Start a community site on the Popular Astro theme: npm create popular-site@latest",
+  "type": "module",
+  "license": "MIT",
+  "author": "Mariatta",
+  "homepage": "https://popular.mariatta.ca/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Mariatta/astro-theme-popular.git",
+    "directory": "create-popular-site"
+  },
+  "keywords": [
+    "astro",
+    "astro-theme",
+    "create",
+    "community",
+    "meetup"
+  ],
+  "bin": {
+    "create-popular-site": "index.mjs"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "prepack": "node scripts/collect-templates.mjs"
+  },
+  "files": [
+    "index.mjs",
+    "templates",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/templates/aquarium/popular.config.ts

@@ -0,0 +1,224 @@
+/** Popular: theme configuration (Rocky Cove Aquarium Club demo). See README for all options. */
+
+export const SITE = {
+  title: "Rocky Cove Aquarium Club",
+  tagline: "A fictional aquarium club, demo content for the Popular theme",
+  description: "A friendly club for freshwater and saltwater keepers in Rocky Cove. (Rocky Cove is a made-up place, this is example content demonstrating the Popular theme.)",
+  brandName: "Rocky Cove",
+  brandSub: "Aquarium Club",
+  logo: '/images/logo.png',
+  favicon: '/images/logo.png',
+  ogImage: '/images/hero.png',
+  locale: 'en-US',
+  landAcknowledgement: "Add your community's land acknowledgement or welcome statement here, this demo keeps it as a placeholder.",
+  notice: {
+    text: 'Winter break: regular meetups resume in March. **Tanks stay wet**, [pop into the chat](https://example.com/chat) any time.',
+    url: 'https://example.com/news',
+  },
+  community: { chat: { url: 'https://example.com/discord', label: 'Join our Discord' } },
+};
+
+/* UI strings. Translate your site by editing these values; keys map 1:1 to
+   the Hugo theme's i18n/en.toml (see PARITY.md). */
+export const STRINGS: Record<string, string> = {
+  skipToContent: 'Skip to content',
+  primaryNav: 'Primary',
+  toggleMenu: 'Toggle menu',
+  nextMeetup: 'Next meetup',
+  venueTba: 'Venue to be announced',
+  eventCancelled: 'Cancelled',
+  rsvp: 'RSVP',
+  rsvpExternal: 'RSVP on Luma',
+  allEvents: 'All events',
+  allSpeakers: 'All speakers',
+  allVenues: 'All venues',
+  allOrganizers: 'All organizers',
+  comingUp: 'Coming up',
+  upcomingEvents: 'Upcoming events',
+  upcomingLead: 'Save your seat early, space is limited and our rooms fill up.',
+  noUpcomingEvents: 'Nothing on the calendar right now, follow us to hear when the next one lands.',
+  lookingBack: 'Looking back',
+  pastEvents: 'Past events',
+  venueWanted: 'Venue wanted',
+  confirmed: 'Confirmed',
+  fromTheBlog: 'From the blog',
+  latestFromCommunity: 'Latest from our community',
+  readTheBlog: 'Read the blog',
+  allPosts: 'All posts',
+  filterLabel: 'Filter:',
+  filterAll: 'All',
+  subscribeRss: 'Subscribe via RSS',
+  subscribeCalendar: 'Subscribe to calendar',
+  watchRecording: 'Watch',
+  viewSlides: 'Slides',
+  hasRecording: 'Recording available',
+  talks: 'Talks',
+  talksLead: 'Every talk from our past events, with recordings and slides where we have them.',
+  learnMore: 'Learn more',
+  joinChat: 'Join the chat',
+  speakerInviteTitle: 'Your name here?',
+  speakerInviteBody: 'We are always looking for new voices. Lightning talks welcome, and we will help you prepare.',
+  subscribeRssTitle: 'Follow new posts in any feed reader',
+  noPosts: 'No posts yet, check back soon.',
+  ourSpeaker: 'Our speaker',
+  minRead: '{n} min read',
+  authorsBy: 'By',
+  listSeparator: ', ',
+  listSeparatorFinal: ' & ',
+  posts: 'Posts',
+  guest: 'Guest',
+  website: 'Website',
+  previewLabel: 'Preview',
+  previewBanner: 'This is a preview. Nothing here is published yet.',
+  checklist: 'Checklist',
+  copyCode: 'Copy code',
+  checklistDone: 'done',
+  writtenBy: 'Written by {name}',
+  eyebrowBlog: 'Blog',
+  eyebrowEvents: 'Events',
+  eyebrowAuthor: 'Author',
+  eyebrowDocs: 'Docs',
+  eyebrowTag: 'Tag',
+  taggedCount: '{n} post(s) tagged {tag}',
+  speakers: 'Speakers',
+  eyebrowSpeaker: 'Speaker',
+  eyebrowOrganizer: 'Organizer',
+  sessionsBy: 'Sessions by {name}',
+  eyebrowVenue: 'Venue',
+  gettingThere: 'Getting there & access',
+  wheelchairAccessible: 'Wheelchair accessible',
+  transit: 'Transit',
+  parking: 'Parking',
+  venueEvents: 'Events held here',
+  beforeYouArrive: 'Before you arrive',
+  postNavigation: 'More posts',
+  newerPost: 'Newer post',
+  olderPost: 'Older post',
+  paginationLabel: 'Pagination',
+  paginationPrev: 'Previous',
+  paginationNext: 'Next',
+};
+
+/* List pagination size. Mirrors Hugo's [pagination] pagerSize (see PARITY.md). */
+export const PAGINATION = { pageSize: 3 };
+
+/* Renameable content sections: point post-author bylines or the homepage
+   team grid at a differently-named collection (must exist in your
+   content.config.ts). Defaults are the theme's own section names.
+   Hugo parity: [params.sections] (see PARITY.md). */
+export const SECTIONS_MAP = {
+  authors: 'authors',
+  team: 'organizers',
+};
+
+export const BRAND: Record<string, string> = {
+  primary: "#0f766e",
+  primaryHover: "#0d5f59",
+  primaryActive: "#0b4f4a",
+  secondary: "#0b4f4a",
+  accent: "#b45309",
+  ink: '#142a36',
+  surfaceWash: "#d7ece9",
+  surfaceWashSoft: "#ecf6f4",
+  surfaceInk: '#142a36',
+  fontSans: 'Inter, system-ui, sans-serif',
+  fontDisplay: 'Quantico, Inter, sans-serif',
+};
+
+export const NAV: {
+  label: string;
+  href: string;
+  children?: { label: string; href: string }[];
+}[] = [
+  {
+    label: 'About',
+    href: '/about/',
+    children: [
+      { label: 'About us', href: '/about/' },
+      { label: 'Organizers', href: '/organizers/' },
+    ],
+  },
+  { label: 'Blog', href: '/blog/' },
+  { label: 'Events', href: '/events/' },
+  { label: 'Handbook', href: '/handbook/' },
+];
+
+export const CTA = { label: 'RSVP', url: 'https://example.com/rsvp', icon: 'fa-solid fa-calendar' };
+
+export const SOCIAL = [
+  { label: 'Instagram', icon: 'fa-brands fa-instagram', url: 'https://example.com' },
+  { label: 'Mastodon', icon: 'fa-brands fa-mastodon', url: 'https://example.com' },
+  { label: 'RSS', icon: 'fa-solid fa-rss', url: '/rss.xml' },
+  { label: 'Email', icon: 'fa-solid fa-envelope', url: 'mailto:hello@example.com' },
+];
+
+export const FOOTER = {
+  tagline: "Fish · Plants · Community, an Astro demo site for the Popular theme",
+  credit: { label: 'Popular. An Astro theme by Mariatta.', url: 'https://popular.mariatta.ca/' },
+  columns: [
+    { title: 'Community', links: [
+      { label: 'About us', href: '/about/' },
+      { label: 'Blog', href: '/blog/' },
+      { label: 'Code of Conduct', href: '/code-of-conduct/' },
+    ]},
+    { title: 'Get involved', links: [
+      { label: 'Host a session', href: '/get-involved/' },
+      { label: 'Offer a venue', href: '/get-involved/' },
+      { label: 'Organizers', href: '/organizers/' },
+    ]},
+    { title: 'Organizers', links: [
+      { label: 'Organizer Handbook', href: '/handbook/' },
+      { label: 'Meetup Runbooks', href: '/runbooks/' },
+    ]},
+  ],
+};
+
+/** Support box at the bottom of blog posts, null hides it. */
+export const SUPPORT = null;
+
+/** Section list-page headers. */
+export const SECTIONS = {
+  blog: { eyebrow: 'Blog', title: 'From our community', lead: "Recaps and spotlights from Rocky Cove Aquarium Club, example posts showing the theme's blog." },
+  events: { eyebrow: 'Events', title: 'Upcoming gatherings & announcements', lead: 'All events are free, and newcomers are always welcome.' },
+  organizers: { eyebrow: 'The team', title: 'Organizers', lead: "Rocky Cove Aquarium Club is run entirely by volunteers. Want to help? We'd love to have you." },
+  speakers: { eyebrow: 'Speakers', title: 'Speakers', lead: 'Everyone who has taken the mic at one of our gatherings.' },
+  venues: { eyebrow: 'Venues', title: 'Venues', lead: 'The rooms that host us.' },
+};
+
+export const HOME = {
+  hero: {
+    eyebrow: "Fish · Plants · Community",
+    title: "For everyone who's ever lost an hour watching a tank",
+    lead: "Rocky Cove Aquarium Club is a friendly group of freshwater and saltwater keepers. Whether you run a nano shrimp bowl or a full reef system, or you're still dreaming about your first tank, you're welcome here.",
+    image: '/images/hero.png',
+    ctas: [
+      { label: 'RSVP', url: 'https://example.com/rsvp', icon: 'fa-solid fa-calendar', variant: 'primary' },
+      { label: 'About us', url: '/about/', variant: 'outline' },
+    ],
+  },
+  stats: [{ value: "2019", label: "club founded" }, { value: "All", label: "tanks welcome" }, { value: "Free", label: "to attend" }, { value: "Monthly", label: "meets in Rocky Cove" }],
+  featuresHead: { eyebrow: 'What we do', title: "What Rocky Cove Aquarium Club is all about", lead: 'No experience necessary, come as you are.' },
+  features: [
+    { icon: "fa-solid fa-fish", title: "Show & tell nights", body: "Bring photos (or a jar of shrimp) and share what's growing, spawning or misbehaving in your tank." },
+    { icon: "fa-solid fa-seedling", title: "Hands-on workshops", body: "Aquascaping, planted tanks and CO₂, water chemistry, learn by doing, with helpers at every table." },
+    { icon: "fa-solid fa-arrows-rotate", title: "Swap meets", body: "Trade plants, shrimp and frags with other keepers. One keeper's trimmings are another's new scape." },
+  ],
+  testimonialsHead: { eyebrow: 'Kind words', title: 'What members say' },
+  testimonials: [
+    { quote: "I joined with one betta. I now run three tanks and have zero regrets.", name: "Priya", role: "Freshwater keeper" },
+    { quote: "The only place where 'my tank crashed' gets you sympathy and a rescue plan in the same breath.", name: "Marcus", role: "Reef keeper" },
+    { quote: "The swap meet furnished my entire aquascape. My wallet thanks this club.", name: "Elle", role: "Plant person" },
+  ],
+  getInvolved: {
+    eyebrow: 'Community',
+    title: "There's a seat (and a tank) for everyone",
+    lead: "Host a session, offer a venue, or just come watch the fish with us.",
+    ctas: [
+      { label: 'Get involved', url: '/get-involved/', variant: 'primary' },
+      { label: 'Read the handbook', url: '/handbook/', variant: 'outline' },
+    ],
+  },
+};
+
+/** Demo-only switcher bar. Adopters: set to null (or delete the demo bar usage). */
+export const DEMO_BAR = null;

package/templates/aquarium/src/content/authors/nadia.md

@@ -0,0 +1,13 @@
+---
+title: "Nadia Reyes"
+role: "Lead organizer"
+photo: "/images/organizer-1.png"
+bio: "Keeps the club running, welcomes newcomers, and can identify most plecos on sight."
+website: "https://example.com"
+social:
+  - label: "Mastodon"
+    icon: "fa-brands fa-mastodon"
+    url: "https://example.com"
+---
+
+Nadia founded Rocky Cove Aquarium Club after her third "one last tank." She writes most of our recaps.

package/templates/aquarium/src/content/blog/aquarium-field-trip.md

@@ -0,0 +1,14 @@
+---
+title: "Field trip diary: a day at the Vancouver Aquarium"
+date: 2026-02-25
+author: "Nadia"
+description: "Photos and highlights from our winter outing."
+image: "/images/post-3.png"
+tags: ["field-trip", "community"]
+---
+
+Fifteen of us spent a rainy Saturday exactly where we wanted to be: in front of very large tanks.
+
+Highlights included the kelp forest exhibit, a spirited discussion about sump design, and one member taking ninety-two photos of the same anemone.
+
+We left inspired, humbled, and with a shared list of wildly unrealistic dream-tank plans.

package/templates/aquarium/src/content/blog/fresh-vs-salt-recap.md

@@ -0,0 +1,23 @@
+---
+title: "Freshwater vs saltwater: what our panel actually agreed on"
+date: 2026-04-20
+guestAuthors:
+  - name: "Wren Alvarez"
+    title: "Guest writer · reef keeper"
+    photo: "/images/organizer-2.png"
+    bio: "Wren keeps a 90-gallon reef and moderates a saltwater forum. This is a one-off guest recap, no author profile page needed."
+    website: "https://example.com"
+    social:
+      - label: "Instagram"
+        icon: "fa-brands fa-instagram"
+        url: "https://example.com"
+description: "Two camps, one hobby, the friendly debate, recapped."
+image: "/images/post-2.png"
+tags: ["panel", "community"]
+---
+
+We expected a rivalry; we got a love-in. Both panels agreed on more than they disagreed: stability beats gadgets, water changes beat additives, and the best tank is the one you'll actually maintain.
+
+The saltwater camp made their case with a rock-solid frag display; the freshwater camp countered with a carpet of Monte Carlo that drew audible gasps.
+
+We'll call it a draw, until the rematch.

package/templates/aquarium/src/content/blog/new-tank-101-recap.md

@@ -0,0 +1,14 @@
+---
+title: "New tank 101 recap: five tanks, zero panic"
+date: 2026-06-24
+authors: ["nadia"]
+description: "What twenty beginners learned setting up their first tanks together."
+image: "/images/post-1.png"
+tags: ["workshop", "beginners"]
+---
+
+Our biggest beginner night yet. Twenty new keepers, five demo tanks, and one very patient discussion about the nitrogen cycle.
+
+The highlight was watching first-timers realize that a beautiful tank is mostly patience: cycle first, stock slowly, and let the plants do the work.
+
+Thank you to everyone who brought spare equipment for the giveaway table, three members went home with their first complete setup.