A high-performance, SEO-first CMS built with Next.js 15+ (App Router), TypeScript, and Tailwind CSS 4, using GitHub as the data store.
- GitHub as CMS: Content lives in your repository as Markdown/MDX.
- Extreme Speed: Static generation (SSG) with Incremental Static Regeneration (ISR).
- SEO-First: Automated JSON-LD, Sitemaps, Robots.txt, and Meta Tags.
- Customizable: Change colors, fonts, and site info from a single
config.mdfile. - Mobile-First: Fully responsive navigation and layout.
- Dark/Light Mode: Full theme customization for both modes.
- Use this Template: Click the "Use this template" button on GitHub to create your own repo.
- Setup Environment:
cp .env.example .env.local
- Configure: Edit
src/content/config.mdto change your site's identity and colors. - Run:
pnpm install pnpm dev
This template is optimized for Agent-Developer Experience (ADX). Instead of complex, limited configuration flags, we provide lean, high-performance default components that are designed to be easily modified by AI coding agents.
- Clone the repo.
- Fire up your Agent (Pi, Claude Code, Cursor, etc.).
- Ask for what you want: "Make the navbar floating and rounded," "Add a newsletter section," "Change the blog layout to a grid."
Agents should read AGENTS.md for specific instructions on how to maintain the site's performance and SEO while fulfilling user requests.
Site-wide data and brand colors are managed in src/content/config.md.
| Variable | Description |
|---|---|
GITHUB_TOKEN |
(Required for Production) A Personal Access Token with repo read access. |
GITHUB_OWNER |
Your GitHub username. |
GITHUB_REPO |
The name of your repository. |
Deploy to Vercel with one click:
- Add your environment variables in the Vercel dashboard.
- Set the Build Command to
pnpm build.
/src/content/posts: Your blog posts (Markdown)./src/content/config.md: Global site configuration and theme./src/lib/github.ts: The logic that fetches and parses your content./src/components: Reusable UI components.