Introducing Minima: The Default Jekyll Theme

Minima is the foundational, default theme for Jekyll. Designed for simplicity and efficiency, it is the immediate starting point for anyone running the jekyll new command. It provides a zero-configuration experience, offering all the necessary scaffolding to get a professional website online instantly.

Purpose and Design Philosophy

The primary goal of Minima is to provide a clean, unobtrusive aesthetic that works out of the box. By utilizing a modular architecture based on Sass and Liquid templates, Minima allows users to launch a site with no setup and then gradually customize it to fit their specific branding and functional needs.

Key Features

Flexible Layout System

Minima utilizes a hierarchical layout structure to ensure consistency across different page types:

  • Base Layout (base.html): The foundation for all other layouts, handling the core HTML structure.
  • Home Layout (home.html): A dynamic landing page that allows for custom content injection above an automatically generated list of posts.
  • Page & Post Layouts: Specialized templates for standard documents and blog posts.

Advanced Styling and Skins

Starting with version 3.0, Minima introduced a robust skinning system, allowing users to switch entire color palettes via a simple configuration change.

  • Available Skins: Options include classic (light), dark, solarized, and specific light/dark variants of Solarized.
  • Adaptive Skins: The auto and solarized skins utilize CSS Media Queries (prefers-color-scheme) to automatically switch between light and dark modes based on the visitor’s operating system or browser settings.
  • Sass Customization: Users can override specific variables or styles via custom-variables.scss and custom-styles.scss without needing to maintain the entire stylesheet.

Integrated Components and Includes

To keep code DRY (Don’t Repeat Yourself), Minima uses a series of includes for common site elements:

  • Navigation: A configurable navigation bar where links and their order can be managed directly from the _config.yml file.
  • Social Integration: A dedicated social links system that renders Font Awesome icons via CDN, based on configuration pairs of titles, icons, and URLs.
  • Footer & Header: Standardized sections that provide a cohesive look across the site.

Built-in Production Tools

Minima is designed to be production-ready with integrated support for:

  • SEO: Pre-installed with the jekyll-seo-tag plugin for optimized meta tags.
  • Analytics: Simple integration for Google Analytics.
  • Engagement: Native support for Disqus comments on blog posts.

Potential Use Cases

Minima’s versatility makes it suitable for a wide range of small-to-medium web projects:

  • Personal Blogs: With its automated post-listing and excerpt support, it is ideal for writers and hobbyists.
  • Professional Portfolios: The ability to create custom pages and a tailored navigation menu makes it a strong choice for showcasing work.
  • Project Documentation: Its clean typography and simple structure are well-suited for technical documentation or project landing pages.
  • Developer Sites: Given its integration with Jekyll and GitHub Pages, it is the go-to choice for developers who want a low-maintenance, Markdown-driven site.

Installation and Setup

Minima can be integrated into a Jekyll project by adding the gem to the Gemfile:

gem "minima"

After running bundle, the theme is activated by adding the following to the _config.yml file:

theme: minima