Clean, fast, content‑first blog starter with Next.js 15, React 19, and MDX.

pnpm install
pnpm dev

Open http://localhost:3000

See docs/index.md for plugin documentation.

app/        Pages and routes
components/ UI and MDX components
content/    Blog posts (MDX)
lib/        Utilities and site config
  plugins/  Plugin implementations
config/     YAML config (seo, projects, plugins)
docs/       Documentation

• pnpm dev — start the dev server
• pnpm build — production build
• pnpm start — run the production server
• pnpm export — static export to out/
• pnpm preview — serve the exported site from out/

Giscus enables GitHub Discussions-powered comments on blog posts.

1. Visit giscus.app
2. Enter your repo (e.g., username/repo)
3. Enable Discussions in your GitHub repo settings
4. Copy the generated IDs
5. Update config/plugins.yaml:

giscus:
  enabled: true
  repo: "username/repo"
  repoId: "your-repo-id"
  category: "General"
  categoryId: "your-category-id"

See config/plugins.yaml for all options (theme, position, etc).

Build and run the static site with Caddy on port 80:

docker build -t monolog-blog .
docker run -d -p 80:80 --name monolog monolog-blog

Then open http://localhost.

Note: Static export is handled during next build via output: 'export' in next.config.ts.

pnpm install
pnpm dev

Open http://localhost:3000.

MIT

Inspired by leerob.com and based on leerob/next-mdx-blog.