Miniscule is a clean and light Jekyll theme for GitHub Pages, created by Filbert Phang as a custom variant of Jekyll's default minima theme.
What is Miniscule?
Miniscule is a Jekyll theme that produces a static website from Markdown content and Liquid templates, designed to be hosted on GitHub Pages. It is based on the jekyll/minima repository, so it inherits minima's minimal layout and structure while adding a custom look. The theme was written for the author's own GitHub Pages site and is available as a public repository with a live demo at https://filbertphang.github.io/miniscule.
Key Features
- Clean and light design — A minimal visual style inherited from jekyll/minima, intended to keep pages simple and readable.
- Based on jekyll/minima — Built directly on Jekyll's default theme, sharing its templates, layouts, and compatibility with Jekyll's ecosystem.
- GitHub Pages ready — Designed specifically for GitHub Pages; the demo site is hosted at filbertphang.github.io/miniscule.
- Landing page support — The repository topics include "landing-page", indicating the theme can be used for a single-page profile or link-in-bio page.
- Demo site with instructions — The demo site provides installation and usage guidance, making it easy to try the theme.
Who is it for?
- Jekyll users who want a minimal theme that starts from minima but has a customized presentation.
- Personal site owners who publish on GitHub Pages and want a lightweight page without a heavy front-end framework.
- Theme developers looking for a small, readable codebase to fork and reuse; the project is open source and offers a clear starting point.
What can you do with Miniscule?
- Create a personal landing page — Set up a one-page site with your name, bio, and links using the theme's clean layout.
- Run a simple blog — Since it is based on minima, you can write Markdown posts and Jekyll generates a blog structure automatically.
- Customize the theme — Fork the repository and edit the Liquid templates and CSS files to change typography, colors, and layout.
FAQ
Is Miniscule free to use?
The repository is public on GitHub, so you can download, use, and modify the theme code without paying any license fee. No explicit license is mentioned in the README, so check the repository for licensing details.
Does Miniscule work with GitHub Pages automatically?
Yes, it is built for GitHub Pages. The demo is hosted on GitHub Pages, and you can use it as a remote theme by specifying the repository name in your _config.yml file.
What is the difference between Miniscule and the default minima theme?
Miniscule is a customized version of minima with a clean and light design tailored for the author's site. The README does not list every change, but the design and structure are simplified for a personal landing page.
