Skip to content

refixai/blog

Repository files navigation

Refix Blog

The Refix blog — blog.refix.ai. Built on the QuietPages Astro theme (MIT).

Stack

  • Astro 6 — static site, MDX content collections
  • Tailwind CSS 4 — via @tailwindcss/vite, tokens in src/styles.css
  • MDX posts in src/content/blog
  • Self-hosted Inter, Fraunces & JetBrains Mono fonts
  • RSS (/rss.xml), XML sitemap (/sitemap.xml), dynamic robots.txt
  • Deployed as a static site on Netlify (pnpm builddist/)

Running locally

pnpm install
pnpm dev

Site runs at http://localhost:4321

Adding a post

Each post is a folder under src/content/blog/<slug>/ containing:

  • index.mdx — the post (filename slug = URL, served at /blog/<slug>)
  • cover.jpg (or any image) — the thumbnail, referenced as thumbnail: ./cover.jpg

Required frontmatter (validated in src/content.config.js):

---
title: "Post title"
excerpt: "One-line summary used in cards and meta description."
date: 2026-01-15
readingTime: 5            # minutes, integer
category: "analytics"      # slug from src/lib/blog-data.js
tags: ["analytics", "ai"]  # slugs from src/lib/blog-data.js
author: "refix"            # slug from src/lib/blog-data.js
thumbnail: ./cover.jpg
featured: false            # optional — true pins it as the homepage lead
---

Authors, categories, and tags are defined in src/lib/blog-data.js. Site name, description, and URL live in the SITE export there.

Commands

Command Action
pnpm install Install dependencies
pnpm dev Start dev server at localhost:4321
pnpm build Build to ./dist/
pnpm preview Preview the production build
pnpm format Format with Prettier

TODO

  • Visual editor: no CMS is wired up (Tina was removed in the re-theme). Add Keystatic when a non-technical editor is needed — it's git-backed and pairs cleanly with Astro 6, writing back to these same MDX files.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

Packages

 
 
 

Contributors