Metarics

The website for Metarics, a college club — built to handle posts and updates written in Markdown/MDX, with a fast, content-heavy static frontend.

Features

• Blog posts authored in Markdown/MDX with frontmatter (title, description, tags, author, category), rendered through Astro content collections
• Client-side full-text search over posts via Lunr, with a search index built at postbuild
• Firebase-backed auth (sign in / register / sign out) and per-post view counts, tracked through API routes
• RSS feed and sitemap generation
• Lightweight and fast — Astro ships almost no JavaScript by default

Getting started

yarn install
yarn dev

Open http://localhost:3000.

Requires Firebase project credentials (client + admin SDK) for auth and view-count tracking — see src/firebase.

Built with

• Astro — content collections, MDX, Markdoc
• Svelte + React — interactive components
• Firebase (client + admin) — auth, view counts
• Lunr — client-side search index
• Tailwind CSS
• Deployed on Vercel

What I learnt

• How Astro's content collections and static generation work
• Why content-heavy sites benefit from shipping minimal JavaScript
• Working with Markdown as a data format rather than just a rendering target