Hakuba

• Purpose: Hakuba is a fast blog starter that fetches content from GitHub Discussions using GitHub's GraphQL API and webhooks, then renders blog pages from that data.
• Target Audience: Bloggers and developers who want a lightweight, GitHub-integrated blogging solution.
• Key Features:
  • Reads data from GitHub Discussions to generate blog posts and pages.
  • Supports MDX and HTML script tags for posts and pages (with security warnings).
  • SEO-friendly with configurable metadata (title, description, keywords, etc.).
  • Supports RSS feeds if a domain is provided.
  • Includes comment functionality (enabled by default).
  • Supports multiple languages and timezones.
• Framework Support: Primarily built with Svelte (implied by the use of Mdsvex for markdown processing).
• Customization:
  • Configurable via environment variables or GitHub Discussions (e.g., blog name, bio, social links).
  • Supports front matter for posts and pages (e.g., language, comments, paths, excerpts).
• Deployment Options:
  • Hosting services like Vercel, Netlify, or Cloudflare Pages.
  • Manual deployment via Git clone and build.
• Automation:
  • Webhooks for automatic content updates when discussions are modified.
  • Dependabot for dependency updates.
• Limitations:
  • Mdsvex markdown preprocessing restricts 4-space indented code blocks.
  • Security note: Discussions should not be publicly editable due to MDX/HTML support.
• Roadmap:
  • Planned features include dark mode, lazy loading, page transitions, and a logo design.
• Inspiration: Theme inspired by hexo-theme-cactus .
• License: GPL-3.0.