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 StartGet your first Hakuto site up and running in about 5 minutes. All you need is Claude Code, GitHub, Cloudflare, and a code editor.Custom DomainConnect your own domain to your Cloudflare Worker. Add the domain, update wrangler.toml, and hide the workers.dev URL from the public.Environment VariablesHow to manage API keys, secrets, and configuration values for your Hakuto site on Cloudflare Workers.Update HakutoHow updates work with the Hakuto plugin. Covers /plugin update, scaffold drift, and dependency updates.
Tips
Create a BlogAdd a blog to your Hakuto site with a listing page, post templates, and category pages using the built-in Skill.Create Docs PagesAdd a documentation section to your Hakuto site with sidebar navigation, content collections, and organized category pages.FaviconsAdd custom favicons to your Hakuto site. Covers SVG and PNG sources, dark mode and light mode variants, and how the favicons plugin works.Site LaunchA pre-launch checklist for your Hakuto site. Run the prelaunch-checklist skill, then handle the manual Cloudflare steps the skill can't automate.Build FailedHow 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 NewbiesA plain-English guide to Git and GitHub for non-developers. Covers commits, branches, pull requests, and common tasks when using Hakuto.
Customization
Skills CustomizationHow 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 StructureUnderstand 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.