Estimated reading time: 1 minute
Page Improvements
- Improve Page Polish content, structure, and presentation of this page
- Expand Page Add depth, examples, and missing sections to this page
- Update Page Refresh outdated content, versions, links, and screenshots
- Fix Page Issue Report a typo, broken link, layout glitch, or content bug
- SEO Optimize Improve discoverability, metadata, and structured data
- Accessibility Audit Audit this page for WCAG 2.1 AA compliance
Site Improvements
- UI/UX Improvement Propose a design or UX refinement for the theme
- New Feature Propose a new site-wide feature or capability
- Component Enhancement Improve a Jekyll layout, include, or shared component
- Performance Optimization Improve load time, Core Web Vitals, and asset delivery
Table of Contents
SCHEMA — assets
Site-owned static assets — everything else (Bootstrap, theme CSS/JS, layout assets) ships inside the jekyll-theme-zer0 gem.
Structure
| entry | kind | purpose | rules |
|---|---|---|---|
backgrounds/ |
dir | Theme background textures referenced by _data/theme_backgrounds.yml | |
css/ |
dir | Site CSS override hook loaded after the theme’s stylesheets | |
images/ |
dir | Site imagery — identity art, author avatars, docs screenshots, generated preview banners | |
js/ |
dir | Site JS override hook loaded by the theme |
Placement
- Site-specific styles →
css/user-overrides.css; site-specific scripts →js/user-overrides.js. - New images → the matching subdirectory of
images/(see its SCHEMA.md).