Announcing Analytiq Pages Theme: A Modern Jekyll Theme with Tailwind CSS

• ✍️

🎉 We’re excited to announce the release of Analytiq Pages Theme v0.1.6 - a modern, feature-rich Jekyll theme that transforms our Analytiq Pages approach into a reusable, professional-grade solution for building beautiful company websites.

The Evolution: From Method to Theme

Analytiq Pages started as a methodology for building company websites using Jekyll, GitHub Pages, and Tailwind CSS. Today, we’re proud to release it as Analytiq Pages Theme - a fully packaged Jekyll theme that makes this powerful combination accessible to everyone.

Before: Analytiq Pages

A methodology requiring manual setup of Jekyll, Tailwind, and custom configurations for each site.

Now: Analytiq Pages Theme

A complete, ready-to-use Jekyll theme with all features pre-configured and professionally designed.

✨ What’s New in Analytiq Pages Theme

🚀 Advanced Features

  • Tailwind CSS Integration: Modern, responsive design with utility-first styling
  • Enhanced Syntax Highlighting: Beautiful code blocks with copy functionality using highlight.js
  • Interactive Diagrams: Full Excalidraw integration for creating and embedding technical diagrams
  • Professional Blog Layouts: Complete blog system with sidebar, pagination, and category support
  • Responsive Navigation: Mobile-first navigation with dropdown menus and hamburger menu
  • Dark Theme Support: Built-in dark mode (Minima skin) for modern aesthetics

🛠 Developer Experience

  • Three Customization Hooks: Override custom-head.html, custom-header.html, and custom-footer.html for site-specific modifications
  • Reusable Components: Pre-built Tailwind components (alerts, buttons, cards)
  • SEO Optimized: Integrated jekyll-seo-tag for better search engine visibility
  • PDF Embedding: Native support for embedding PDF documents
  • RSS Feed Generation: Automatic blog feed generation with jekyll-feed

🎨 Content Features

  • MathJax Support: Render mathematical equations in your content
  • Multiple Layouts: Specialized layouts for homepages, blog posts, documentation, and more
  • Excalidraw Editor: Built-in diagram editor accessible at /excalidraw-edit
  • Smart Embeds: Flexible diagram embedding with static, interactive, and link modes

Installation: Get Started in Minutes

Option 1: Quick Start with Existing Site

Add to your Jekyll site’s Gemfile:


gem "analytiq-pages-theme", git: "https://github.com/analytiq-hub/analytiq-pages-theme"

Or for a specific stable version:


gem "analytiq-pages-theme", git: "https://github.com/analytiq-hub/analytiq-pages-theme", tag: "v0.1.6"

Update your _config.yml:

theme: analytiq-pages-theme

Install and serve:

bundle install
bundle exec jekyll serve

Option 2: New Site from Scratch

The simplest way to get started:

# Create new Jekyll site
jekyll new my-company-site
cd my-company-site

# Replace minima theme with analytiq-pages-theme in Gemfile
sed -i 's/gem "minima".*/gem "analytiq-pages-theme", git: "https:\/\/github.com\/analytiq-hub\/analytiq-pages-theme", tag: "v0.1.6"/' Gemfile

# Configure theme in _config.yml
sed -i 's/^theme: .*/theme: analytiq-pages-theme/' _config.yml

# Install and serve
bundle install
bundle exec jekyll serve

Or if you prefer manual editing:

# Create new Jekyll site
jekyll new my-company-site
cd my-company-site

# Edit Gemfile: replace the minima line with:
# gem "analytiq-pages-theme", git: "https://github.com/analytiq-hub/analytiq-pages-theme", tag: "v0.1.6"

# Edit _config.yml: replace the theme line with:
# theme: analytiq-pages-theme

# Install and serve
bundle install
bundle exec jekyll serve

Visit http://localhost:4000 to see your new site!

Option 3: Local Installation (Alternative)

If you encounter repository access issues, you can install the theme locally:

# Download the theme release
curl -L https://github.com/analytiq-hub/analytiq-pages-theme/archive/refs/tags/v0.1.6.zip -o theme.zip
unzip theme.zip
mv analytiq-pages-theme-0.1.6/ _themes/analytiq-pages-theme/

# Or clone locally if you have access
git clone https://github.com/analytiq-hub/analytiq-pages-theme.git _themes/analytiq-pages-theme
cd _themes/analytiq-pages-theme && git checkout v0.1.6

# Add to _config.yml
echo "theme: _themes/analytiq-pages-theme" >> _config.yml

Key Improvements Over Manual Setup

Before (Analytiq Pages Method)

  • Manual Tailwind CSS configuration
  • Custom Jekyll setup for each project
  • Repeated configuration of syntax highlighting
  • Manual Excalidraw integration setup
  • No standardized component library

After (Analytiq Pages Theme)

  • One-line installation: theme: analytiq-pages-theme
  • Pre-configured features: Everything works out of the box
  • Professional components: Reusable Tailwind components included
  • Advanced integrations: Excalidraw, MathJax, PDF embeds ready to use
  • Consistent experience: Standardized layouts and styling across sites

Showcase: Real-World Examples

The theme powers several professional websites:

Migration Guide: Upgrading from Analytiq Pages

If you’re currently using the Analytiq Pages methodology, migration is straightforward:

  1. Add the theme to your Gemfile and _config.yml
  2. Remove manual Tailwind configuration (now handled by the theme)
  3. Update custom includes to use the new hook system
  4. Migrate Excalidraw files to assets/excalidraw/ directory

Your existing content and configuration will continue to work seamlessly.

Technical Architecture

The theme is built with modern web standards:

analytiq-pages-theme/
├── _layouts/           # 5 specialized layouts
├── _includes/          # 16+ reusable components
├── assets/
│   ├── css/           # Tailwind + custom styles
│   └── js/            # Pagination, Excalidraw renderer
├── _config.yml        # Default configuration
└── analytiq-pages-theme.gemspec

Dependencies:

  • Jekyll >= 3.9, < 5.0 (supports both GitHub Pages and Jekyll 4.x)
  • jekyll-feed ~> 0.12
  • jekyll-seo-tag ~> 2.6
  • jekyll-pdf-embed ~> 1.1

Why Choose Analytiq Pages Theme?

For Startups & Small Businesses

  • Zero hosting costs with GitHub Pages
  • Professional appearance without design costs
  • Content-first approach with Markdown simplicity
  • Scalable foundation that grows with your business

For Agencies & Consultants

  • Rapid deployment for client websites
  • Consistent branding across projects
  • Advanced features for technical content
  • Easy customization for client-specific needs

For Enterprise Teams

  • Git-based workflows for version control and collaboration
  • Security compliance with GitHub’s enterprise infrastructure
  • SEO optimization built-in
  • Extensible architecture for custom requirements

Troubleshooting

Jekyll Version Compatibility

The theme supports both Jekyll 3.9+ (GitHub Pages) and Jekyll 4.x (modern installations). If you encounter version conflicts:

# For GitHub Pages compatibility (Jekyll 3.x)
gem "github-pages", group: :jekyll_plugins

# For modern Jekyll 4.x installations
gem "jekyll", "~> 4.3"

The theme will work with either version automatically.

Bundle Install Issues

# Clear bundle cache
bundle cache clean --force

# Clear bundler git cache
rm -rf ~/.local/share/gem/ruby/cache/bundler/git/

# Try installing again
bundle install

Theme Not Loading

  • Verify _config.yml has theme: analytiq-pages-theme
  • Clear Jekyll cache: rm -rf _site .jekyll-cache
  • Rebuild: bundle exec jekyll build

Getting Help & Contributing

  • Documentation: Comprehensive README at analytiq-pages-theme
  • Issues & Support: GitHub Issues for bug reports and feature requests
  • Contributing: Pull requests welcome for theme improvements
  • Migration Support: Contact us for help upgrading from manual Analytiq Pages setups

How This Fits Into Your Stack

Analytiq Pages Theme transforms our proven methodology into a professional, reusable solution that makes building beautiful company websites accessible to everyone. Whether you’re launching a startup, building client sites, or managing enterprise web presence, this theme delivers the perfect balance of simplicity and power.

Ready to upgrade your web presence? Try Analytiq Pages Theme today!

This theme powers the very website you’re reading now. Experience the Analytiq Pages Theme in action and see the source code for implementation examples.

📢 Join the discussion on LinkedIn about modern Jekyll themes and web development workflows.