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. Custom Domain Connect your own domain to your Cloudflare Worker. Add the domain, update wrangler.toml, and hide the workers.dev URL from the public. Environment Variables How to manage API keys, secrets, and configuration values for your Hakuto site on Cloudflare Workers. Update Hakuto How updates work with the Hakuto plugin. Covers /plugin update, scaffold drift, and dependency updates.
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. Run the prelaunch-checklist skill, then handle the manual Cloudflare steps the skill can't automate. 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.