Welcome to Hakuto
Hakuto is a free, open-source framework for building fast, modern websites with Astro and Claude Code. It gives AI the context it needs to produce production-quality pages — from design systems and SEO to forms, blogs, and analytics.
Setting Up
Quick Start Get your first Hakuto site up and running in about 5 minutes. All you need is Claude Code, GitHub, Cloudflare, and a code editor. Contact Form How to add a working contact form to your Astro site using a Cloudflare Worker to handle submissions. Custom Domain Connect your own domain to your Cloudflare Worker in three steps. Add the domain, merge the config PR, and disable the workers.dev URL. Environment Variables How to manage API keys, secrets, and configuration values for your Hakuto site on Cloudflare Workers. Update Hakuto How to update your Hakuto site to the latest template version. Covers pulling the newest release, updating Skills, Tailwind CSS, and Astro dependencies.
Tips
Create a Blog Add a blog to your Hakuto site with a listing page, post templates, and category pages using the built-in Skill. Create Docs Pages Add a documentation section to your Hakuto site with sidebar navigation, content collections, and organized category pages. Favicons Add custom favicons to your Hakuto site. Covers SVG and PNG sources, dark mode and light mode variants, and how the favicons plugin works. Site Launch A pre-launch checklist for your Hakuto site. Covers content review, technical checks, performance validation, and what to do after going live. Build Failed How to diagnose and fix a failed Cloudflare build for your Hakuto site. Covers finding error logs, sharing them with Claude, and re-running builds. GitHub Newbies A plain-English guide to Git and GitHub for non-developers. Covers commits, branches, pull requests, and common tasks when using Hakuto.
Customization
Skills Customization How Hakuto Skills work, what each built-in Skill does, and how to create your own custom Skills to extend Claude Code for your project. Project Structure Understand how a Hakuto project is organized. Covers directory layout, key config files, page routing, and where components live.
Need help? Can't find what you're looking for? Start a discussion on GitHub or open an issue to request a guide.