Features
By Amr
Comprehensive list of zer0-mistakes Jekyll theme features with documentation links and implementation details
Estimated reading time: 39 minutes
Table of Contents
Features
Complete feature registry for the zer0-mistakes Jekyll theme. All 59 features are documented with references, links, and implementation details.
🏗 Core Infrastructure
Bootstrap 5.3.3 Theme Integration
Professional Jekyll theme with Bootstrap 5.3.3 CDN integration, responsive design, and custom styling
References:
_layouts/root.html_layouts/default.html_includes/core/head.html_sass/custom.scss_sass/core/_config.yml
Jekyll Collections System
Organized content collections for posts, docs, notebooks, about pages, and quickstart guides with custom permalinks and front matter defaults
References:
_config.ymlpages/_posts/pages/_docs/pages/_notebooks/pages/_about/pages/_quickstart/
Comprehensive Layout System
15+ specialized layouts for different content types with consistent hierarchy and Bootstrap integration
References:
_layouts/root.html_layouts/default.html_layouts/journals.html_layouts/home.html_layouts/landing.html_layouts/notebook.html_layouts/blog.html_layouts/category.html_layouts/collection.html_layouts/index.html_layouts/sitemap-collection.html_layouts/stats.html_layouts/tag.html.github/instructions/layouts.instructions.md
🤖 AI-Powered Features
Modular AI-Powered Installer
Self-healing installer rebuilt as a modular CLI dispatcher with declarative profiles, deploy plugins (Docker, GitHub Pages, custom), AI agent integration, and a cross-platform test matrix. Replaces the monolithic install.sh while preserving the one-line install UX
AI Preview Image Generator
AI-powered automatic preview image generation for posts using OpenAI gpt-image-2 / DALL-E, Stability AI, xAI, or local placeholders. Configurable assets prefix, retro pixel art defaults, batch regeneration
Providers:
- openai: OpenAI gpt-image-2 / DALL-E 3 image generation
- stability: Stability AI Stable Diffusion
- xai: xAI Grok image generation
- local: Local placeholder (no API needed)
AI Agent Integration (Copilot + AGENTS.md)
Comprehensive AI development assistance with the cross-tool AGENTS.md entry point, file-scoped instruction files (layouts, includes, scripts, sass, obsidian, install, features, version-control, testing, documentation), reusable prompts, and Cursor slash-commands
AGENTS.md Cross-Tool Agent Entry Point
Repository-root entry point for AI coding agents (Copilot, Codex, Cursor, Aider, Jules, Continue, Claude Code, …) that links into the layered guidance under .github/. Single source of truth, no per-tool duplication
AIEO Structured Data, FAQ & Glossary
AI-Engine Optimization toolkit: Schema.org JSON-LD, E-E-A-T signals, FAQ page, and glossary collection for stronger AI search and LLM grounding
🔒 Analytics & Privacy
PostHog Privacy-First Analytics
GDPR/CCPA compliant analytics with PostHog integration. Environment-aware loading with granular user consent management
Key Features:
- Production-only loading
- Custom event tracking
- Download tracking
- External link tracking
- Scroll depth measurement
Cookie Consent Management
GDPR/CCPA compliant cookie consent system with granular permissions, 365-day persistence, and Bootstrap modal preferences
Key Features:
- Granular consent categories
- LocalStorage persistence
- Bootstrap modal UI
- Accept/Decline/Manage options
- DNT (Do Not Track) support
Privacy Policy Page
GDPR/CCPA compliant privacy policy with comprehensive data collection transparency and PostHog analytics disclosure
Key Features:
- Data collection disclosure
- User rights explanation
- Cookie usage details
- Third-party services list
- Contact information
Google Analytics
Google Analytics 4 integration for website traffic analysis with privacy-conscious configuration
Key Features:
- GA4 measurement ID support
- Environment-aware loading
- Privacy policy integration
- Cookie consent compatibility
Google Tag Manager
Google Tag Manager integration for centralized tag management and marketing analytics
Key Features:
- Container ID configuration
- Head and body script injection
- Environment-aware loading
- Noscript fallback support
🧭 Navigation & User Interface
Enhanced Sidebar Navigation System
Modern sidebar with Intersection Observer scroll spy, smooth scrolling, keyboard shortcuts, and swipe gestures. 70% reduction in scroll event overhead
Keyboard Navigation System
Comprehensive keyboard shortcuts for power users. Navigate sections, toggle sidebars, and access features without mouse
Keyboard Shortcuts:
- [ - Previous section
- ] - Next section
- Tab - Skip to content
- Swipe - Toggle sidebar (mobile)
Mobile TOC Floating Action Button
Redesigned mobile table of contents access with FAB pattern. Bottom-right positioned 56x56px circular button with proper z-index stacking
Skip-to-Content Accessibility Link
WCAG 2.1 Level AA compliant skip link. Visually hidden until Tab focus, direct jump to main content bypassing navigation
Back to Top Button
Floating button that appears on scroll, allowing users to quickly return to the top of the page with smooth scrolling animation
GitHub Pages-Compatible Live Search
Self-contained client-side search with live modal, JSON index, and keyboard shortcut activation. Algolia-free — works on bare GitHub Pages with no external service or API key
Auto-hide Navigation
Smart navigation bar that hides on scroll down and reappears on scroll up for maximum content visibility
Table of Contents
Automatic table of contents generation from page headings with scroll spy and smooth scrolling
Breadcrumbs Navigation
Hierarchical breadcrumb navigation with Schema.org structured data for SEO and user orientation
Obsidian Local Graph Panel
Standalone neighborhood graph view for the current note, extracted as a reusable include for sidebars and modals
Dynamic Collection-Based Navigation Fallback
Zero-config navigation: when no _data/navigation entry exists, the navbar auto-populates from Jekyll collections so brand-new sites have a usable nav out of the box
ES6 Modular Navigation Architecture
Navigation JavaScript refactored into ES6 modules with hover dropdowns, settings modal, and a navbar that degrades gracefully on slow connections
Dark/Light Mode Toggle
Theme color mode switcher supporting light, dark, and auto modes with system preference detection and localStorage persistence
Bootstrap 5.3.3 Theme Integration
Professional Jekyll theme with Bootstrap 5.3.3 CDN integration, responsive design, and custom styling
Code Copy Button
One-click copy functionality for code blocks with visual feedback and clipboard API integration
Particles Background
Interactive particle animation background using particles.js for visual enhancement on landing pages
Admin Layout & Configuration Dashboards
Admin-style layout and dashboard partials for surfacing site configuration, build info, and feature flags in a single place
📓 Content Management
AI Preview Image Generator
AI-powered automatic preview image generation for posts using OpenAI gpt-image-2 / DALL-E, Stability AI, xAI, or local placeholders. Configurable assets prefix, retro pixel art defaults, batch regeneration
Jupyter Notebook Integration
Full Jupyter notebook support with GitHub Pages compatibility. Automated nbconvert conversion, rich content rendering, and responsive design
Jekyll Collections System
Organized content collections for posts, docs, notebooks, about pages, and quickstart guides with custom permalinks and front matter defaults
Obsidian Vault Integration
Render an Obsidian vault as a Jekyll site without losing wiki-links, embeds, callouts, or backlinks. Includes a Liquid wiki-index, JS client-side resolver, optional Ruby plugin, and a contract that keeps GitHub Pages and self-build deployments rendering identically
Config-Driven Frontmatter Validation
Schema-driven frontmatter validation system with configurable rules per collection. Catches missing required fields, bad date formats, and unknown layouts before Jekyll builds
Notes Collection & Notebook Layout
Dedicated _notes collection alongside _notebooks, with shared standardized layouts for short-form knowledge capture distinct from blog posts
Mermaid Diagram Support
Client-side Mermaid.js integration for 10+ diagram types. GitHub Pages compatible with no build plugins required
Supported Diagram Types:
Data-Driven Roadmap with Auto-Generated Diagram
Roadmap page rendered from a YAML data source, with an auto-generated Mermaid diagram embedded in README.md
🔧 Developer Experience
Comprehensive Testing Suite
Automated testing with core, deployment, and quality test suites. Docker-based testing, CI/CD integration, and detailed reporting
Features:
- Core functionality tests
- Deployment validation
- Code quality checks
- Markdown linting
- YAML validation
Continuous Integration (CI) Workflow
Comprehensive CI pipeline with multi-Ruby version testing, quality checks, and automated deployment validation
Features:
- Multi-Ruby version testing
- Jekyll build validation
- Gem build testing
- Quality checks
- Deployment validation
Automated Release Management
Semantic versioning with automated commit analysis, changelog generation, gem publishing, and GitHub releases. Full release pipeline automation
Features:
- Semantic version bumping
- Commit message analysis
- Automatic changelog updates
- Gem building and publishing
- GitHub release creation
Automated Version Bump Workflow
GitHub Actions workflow for manual version bumping with test execution, changelog updates, and automated tagging
Features:
- Manual workflow dispatch
- Version type selection (patch/minor/major)
- Automated testing
- Changelog updates
- Git tagging
CodeQL Security Scanning
Automated security vulnerability scanning with GitHub CodeQL for Ruby and JavaScript code
Features:
- Ruby code analysis
- JavaScript code analysis
- Automated vulnerability detection
- Security advisories
Config-Driven Frontmatter Validation
Schema-driven frontmatter validation system with configurable rules per collection. Catches missing required fields, bad date formats, and unknown layouts before Jekyll builds
Local Docker Publishing Pipeline
Publish the gem from a clean Docker container locally, mirroring the CI release path for reproducible releases without polluting the host Ruby environment
Modular AI-Powered Installer
Self-healing installer rebuilt as a modular CLI dispatcher with declarative profiles, deploy plugins (Docker, GitHub Pages, custom), AI agent integration, and a cross-platform test matrix. Replaces the monolithic install.sh while preserving the one-line install UX
Features:
- Modular library architecture (scripts/lib/install/)
- Declarative profile templates
- Pluggable deploy targets (Docker, GitHub Pages, custom)
- Cross-platform test matrix
- AI agent integration scaffolding
AI Preview Image Generator
AI-powered automatic preview image generation for posts using OpenAI gpt-image-2 / DALL-E, Stability AI, xAI, or local placeholders. Configurable assets prefix, retro pixel art defaults, batch regeneration
Features:
- Multiple AI provider support
- Automatic image optimization
- Retro pixel art default style
- Front matter integration
- Batch processing
Automated Dependency Updates
GitHub Actions workflow for automated Ruby gem dependency updates with PR creation
Features:
- Automated gem updates
- PR creation
- Bundler compatibility
- Security updates
Shell Script Automation Library
Collection of 15+ automation scripts for building, testing, releasing, and managing the theme
Features:
- Build automation
- Release management
- Testing utilities
- Content conversion
- Error handling
Data-Driven Roadmap with Auto-Generated Diagram
Roadmap page rendered from a YAML data source, with an auto-generated Mermaid diagram embedded in README.md
📚 All Features Reference
📊 Feature Statistics
59
Total Features
59
Implemented
5
AI-Powered
3
Privacy-First
🎯 Feature Categories
_data/features.yml.
For the most up-to-date information, see the features registry on GitHub.