Takuhon
What is Takuhon?
Section titled “What is Takuhon?”Takuhon lets you own your profile — bio, social links, career history, projects, and skills — as a single portable JSON document, and publish it as a mobile-first profile page plus a public API, including JSON-LD for AI agents and search engines.
The canonical data lives in one takuhon.json file on your own server.
Storage backends — Cloudflare KV, a static file, and more — are pluggable
through adapters, so your profile is never locked to a single platform.
Why “Takuhon”? (拓本)
Section titled “Why “Takuhon”? (拓本)”The name Takuhon (拓本) comes from a 2000-year-old craft: pressing paper against a stone inscription to lift a portable rubbing of the original. The stone stays put; the paper carries its imprint anywhere.
- The original is immutable — your career and story at a given moment, like a stone inscription.
- The reproduction is portable —
takuhon.jsonis the rubbing, carried into APIs, JSON-LD, and profile pages. - The reproduction outlasts the platform — when a platform shuts down, your
takuhon.jsonsurvives.
Packages
Section titled “Packages”@takuhon/core— JSON Schema, validation, locale resolution, JSON-LD generation, and storage interfaces@takuhon/api— Hono-based HTTP handlers and an RFC 7807 error envelope@takuhon/ui— React mobile-first profile UI@takuhon/cli—create-takuhonscaffolding and profile commands
Platform adapters (Cloudflare, Vercel, WordPress, Static) build on top of these.
Install
Section titled “Install”npm install -g takuhonThen scaffold your profile and follow Get started for the full walkthrough.
Takuhon is open source under Apache-2.0. Source lives on GitHub; packages are published to npm. It is under active development (Phase 1) — APIs and data shapes may still change.