Keystone is NOT a theme.
It is a construction kit of high-quality UI components for Hugo developers.
Inspired by the shadcn/ui philosophy, Keystone gives you complete ownership and transparency of the code.
We provide the architectural foundation. You build the rest.
Each component is:
- Fully functional out of the box
- Designed to be modified, extended, or stripped down
- Free from hidden abstractions or runtime magic
We build everything on three structural pillars:
Each component targets WCAG 2.2 AA compliance by default.
- Requirements (WCAG/ARIA) are defined at the blueprint level.
- Components are continuously tested using automated tools and manual audits.
All components are designed to work under a strict Content Security Policy (CSP).
- All interactivity uses the Alpine.js CSP Build.
- Development enforces a strict CSP baseline:
default-src 'none';,script-src 'self';,style-src 'self';.
Zero bloat, no hydration delays, and no layout shifts.
- Automated PageSpeed testing is part of the pipeline.
- Real-world performance is validated across multiple devices and network conditions.
Keystone is currently in pre-release. Components are stable, but the library is evolving.
Use this repo as a GitHub Template.
- Click "Use this template" above.
- Components are disabled by default to keep builds minimal.
To add Keystone into an existing project:
- Follow the steps in the Get started documentation.
- Copy/paste individual components as needed.
For further information on installation/usage of the components consult the official documentation