Features
By Amr
Comprehensive list of zer0-mistakes Jekyll theme features with documentation links and implementation details
Estimated reading time: 21 minutes
Table of Contents
Features
Complete feature registry for the zer0-mistakes Jekyll theme. All 28 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
AI-Powered Installation System
Self-healing installation script with 95% success rate. 1,090-line Bash script with intelligent error recovery, platform detection, and automated fixes for 27+ common scenarios
AI Preview Image Generator
AI-powered automatic preview image generation for posts using OpenAI DALL-E, Stability AI, or local placeholders. Configurable via _config.yml with retro pixel art style defaults
Providers:
- openai: OpenAI DALL-E 3 image generation
- stability: Stability AI Stable Diffusion
- local: Local placeholder (no API needed)
GitHub Copilot Integration
Comprehensive AI development assistance with structured instructions, file-specific guidance, and front matter optimization for maximum AI productivity
🔒 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
🧭 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
Bootstrap 5.3.3 Theme Integration
Professional Jekyll theme with Bootstrap 5.3.3 CDN integration, responsive design, and custom styling
📓 Content Management
AI Preview Image Generator
AI-powered automatic preview image generation for posts using OpenAI DALL-E, Stability AI, or local placeholders. Configurable via _config.yml with retro pixel art style defaults
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
Mermaid Diagram Support
Client-side Mermaid.js integration for 10+ diagram types. GitHub Pages compatible with no build plugins required
Supported Diagram Types:
🔧 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
AI-Powered Installation System
Self-healing installation script with 95% success rate. 1,090-line Bash script with intelligent error recovery, platform detection, and automated fixes for 27+ common scenarios
Features:
- One-line installation command
- Automatic platform detection
- Docker dependency validation
- Self-healing error recovery
- Comprehensive logging
AI Preview Image Generator
AI-powered automatic preview image generation for posts using OpenAI DALL-E, Stability AI, or local placeholders. Configurable via _config.yml with retro pixel art style defaults
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
📚 All Features Reference
📊 Feature Statistics
28
Total Features
28
Implemented
3
AI-Powered
3
Privacy-First
🎯 Feature Categories
_data/features.yml.
For the most up-to-date information, see the features registry on GitHub.