Built on Jekyll and UiKit, providing page structures for both portfolio and blog
JekyllPortfolioBlog
jekyll-uikit — Jekyll Portfolio Template
By jpasholk
A free portfolio and blog theme based on Jekyll and UiKit, providing page structures for home, blog, tag archives, search, and a contact form.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Desktop homepage1 / 3
Desktop captureTop of page
Actual screenshot captured by the server browser.
All pages & views 3
Screenshots show visual appearance; interactive behavior may differ.
Recorded 2026-10-02View source
What stands out
A quick read of the recorded project description.
Includes a paginated blog list, an auto-populated tag archive page, and an about page
Supports Algolia search, Formspree contact form, Disqus comments, and Google Analytics
Supports large header images, article reading time, and Twitter Cards and Open Graph metadata
Can be installed by forking, cloning, or as a theme gem; the README states compatibility with GitHub Pages
Uses the MIT license, allowing free use, modification, commercial use, and distribution of this version of the code
Template Details
jekyll-uikit is a Jekyll theme built with YooTheme's UiKit front-end framework, positioned as a portfolio and blog site. The repository is open source under the MIT license and can be installed by forking, cloning, or as a theme gem; the README states it is compatible with GitHub Pages.
The theme includes page structures such as a home page, paginated blog list, tag archive page, and about page, and supports large header images, article reading time, Twitter Cards and Open Graph metadata, Google Analytics, and Disqus comments. Search is provided by Algolia and the contact form is handled by Formspree; both require configuring the corresponding external services yourself. The README also mentions that Staticman integration is still planned.
Usage instructions are mainly placed in the demo site's blog; the repository README only gives gem installation and _config.yml configuration. Demo images come from unDraw and Unsplash, and third-party assets such as fonts and icons must be checked separately under their respective licenses.
JekyllPortfolioBlog
Is it right for your project?
Use Cases
- Building a personal portfolio website with an accompanying blog and tag archive
- Deploying a static site on GitHub Pages and installing it as a theme gem
- Introducing a UiKit-style home page and blog layout to an existing Jekyll site
- A static blog that needs Algolia search, a Formspree form, or Disqus comments
Suitable For
- Developers familiar with Jekyll and Liquid templates who can adjust configuration themselves
- Users who want to quickly start a personal portfolio or blog with a free MIT theme
- Users who need to host the site on GitHub Pages or similar static hosting
- Users willing to register and configure external services such as Algolia and Formspree themselves
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
Add gem "jekyll-uikit" to the Gemfile, set theme: jekyll-uikit in _config.yml, then run bundle or gem install jekyll-uikit
- 2
Usage instructions are in the demo site's blog; the repository README does not expand on specific configuration steps
- 3
Algolia search and the Formspree contact form require applying for and configuring the corresponding service endpoints and keys yourself
- 4
Disqus comments and Google Analytics require filling in their respective site identifiers
- 5
Third-party assets such as demo images, fonts, and icons must be checked under their respective licenses and cannot be judged solely by the code's MIT license
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version in the public repository under the MIT license; the free scope is the code of this version and does not mean external services or third-party assets are free.
Must comply with when using
- Allows free use, modification, commercial use, and distribution of this version of the code.
- When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
- The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.
Additional costs & items to verify
- The contact form relies on the third-party service Formspree; you must register an account and configure the form endpoint yourself, otherwise the form will not work.
- Site search is provided by Algolia; you must register an Algolia account, create an index, and configure API keys yourself, which is an external service dependency.
- Comment functionality relies on the third-party Disqus service and requires configuring a site identifier; Staticman integration is only planned and not yet provided.
- Google Analytics support requires filling in a tracking identifier yourself and is an optional external service configuration.
- Demo site images come from unDraw and Unsplash and must be checked separately under their respective licenses; they are not licensed together with the code's MIT license.
- The README mentions the Formspree form service; actual submissions require configuring a service endpoint, and its usage quotas and fees must be checked separately.
- Demo images, fonts, icons, and other third-party assets must be checked under their respective licenses and cannot be judged solely by the code's MIT license.
- External services such as domains, hosting, databases, payments, or AI may incur additional charges.
View Original Text Basis
Permission is hereby granted, free of charge
Original License Text
Contact forms powered by [Formspree.io](https://formspree.io)!
Original README
lighting fast search with Algolia
Original README
Comments powered by Disqus, with Staticman integration planned.
Original README
Google Analytics support.
Original README
https://github.com/jpasholk/jekyll-uikit/blob/master/LICENSE.txthttps://github.com/jpasholk/jekyll-uikit/blob/master/README.md* [unDraw.co](https://undraw.co) and [Unsplash](https://unsplash.com) for the awesome images used around the site.
Original README
Compiled by DeepSeek based on repository license and README ·2026-10-02. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.
Project checks & description sources
Template Information
- Source platforms
- GitHub
- Documentation and maintenance reference score
- More documented · 77 / 100
- Technologies
- Jekyll
- Website type
- Portfolio · Blog
How this score is calculated
Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.
What to verify for this project
- Repository update recorded
- 2023-11-26
- Screenshot last checked
- 2026-10-02
A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.
The catalog identifies Jekyll as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.
Use a selection guide →How this description was prepared
AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.
Automatically checked against source and license rules; no manual editorial review.
Inspect the recorded source material
SHA-256: 53b04623e0d433358cbf38653c49f68434d53cb81004338ae941cbd971c0703b
2026-10-02T10:48:37.792Z
Source file / repository# jekyll-uikit
[](https://github.com/jpasholk/jekyll-uikit/fork/)
[](https://github.com/jpasholk/jekyll-uikit/stargazers)
[](https://app.netlify.com/sites/ornate-cat-c7fcc8/deploys)
[](https://github.com/jpasholk/jekyll-uikit/blob/master/LICENSE.txt)
[](https://github.com/jpasholk/jekyll-uikit/commits/master)
[](https://github.com/jpasholk/jekyll-uikit/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc)
[](https://rubygems.org/gems/jekyll-uikit)
[](https://github.com/jpasholk/jekyll-uikit/graphs/contributors)
[](https://rubygems.org/gems/jekyll-uikit)
[](https://www.codetriage.com/jpasholk/jekyll-uikit)
[Live Demo](https://jekyll-uikit.jpshlk.com)
## Home Page
Built with [UiKit](https://getuikit.com/) by [YooTheme](https://yootheme.com/), with an elegant homepage, a blog and archive pages, and lighting fast search with Algolia.
# Features
* 100% compatible with GitHub Pages!
* Available to install by forking, cloning, or as a theme gem.
* Responsive layout.
* Contact forms powered by [Formspree.io](https://formspree.io)!
* Paginated blog page with follow links on last page.
* Tag archive page that automatically populates with tags from posts. ie: [tag1, tag2, tag3, etc].
* Optimized for search engines with support for Twitter Cards and Open Graph data.
* Comments powered by Disqus, with Staticman integration planned.
* Google Analytics support.
* Large header image support.
* Reading time for posts and blog index. [Credits](https://carlosbecker.com/posts/jekyll-reading-time-without-plugins/)
## Installation
Add this line to your Jekyll site's `Gemfile`:
```ruby
gem "jekyll-uikit"
```
And add this line to your Jekyll site's `_config.yml`:
```yaml
theme: jekyll-uikit
```
And then execute:
$ bundle
Or install it yourself as:
$ gem install jekyll-uikit
## Usage
* You can find instructions on using this theme in the [blog](https://jekyll-uikit.jpshlk.com/blog/) of the demo site.
## Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/jpasholk/jekyll-uiki. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](https://contributor-covenant.org) code of conduct.
# Credits
This theme wouldn't have been made possible if it wasn't for:
* [Jekyll](https://jekyllrb.com/)
* [UiKit](https://getuikit.com/)
* [freeCodeCamp](https://www.freecodecamp.org/)
* [GitHub](https://www.github.com/)
* [Michael Rose's Minimal Mistakes Theme](https://github.com/mmistakes/minimal-mistakes)
* [Dean Attali's Beautiful-Jekyll Theme](https://github.com/daattali/beautiful-jekyll)
* [David Darnes's Alembic Jekyll Theme](https://github.com/daviddarnes/alembic)
* [James Williamson's Jekyll series on lynda.com](https://www.lynda.com/Jekyll-tutorials/Jekyll-Web-Designers/383124-2.html)
### Also, thanks to
* [Algolia Search](https://www.algolia.com/)
* [OneDarkJekyll](https://github.com/mgyongyosi/OneDarkJekyll) for the syntax highlighting.
* [Snaptortoise's Jekyll RSS Feeds](https://github.com/snaptortoise/jekyll-rss-feeds) for drop in RSS/ Atom feeds.
* [Michael Lanyon's Post](https://blog.lanyonm.org/articles/2013/11/21/alphabetize-jekyll-page-tags-pure-liquid.html) on alphabetizing Jekyll page tags in pure Liquid.
* [StackOverflow](https://stackoverflow.com/search?q=Jekyll) where would we be without StackOverflow?
* [unDraw.co](https://undraw.co) and [Unsplash](https://unsplash.com) for the awesome images used around the site.
* [Michael Woolweaver](https://github.com/mwoolweaver) - a good friend of mine who gave me a nudge in the right direction.
And many other people and things that I am forgetting.
## License
The theme is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
Explore similar templates
Compare previews and descriptions within the same stack and category.
al-folio
A Jekyll academic homepage theme for scholars and researchers, with a clean responsive design and out-of-the-box support for publication lists, project showcases, CVs, and blogs.
Jekyll · Portfolio
minimal-mistakes
Minimal Mistakes is a two-column Jekyll theme for personal sites, blogs, project documentation, or portfolios.
Jekyll · Portfolio
Beautiful Jekyll
Beautiful Jekyll is a mature, easy-to-use Jekyll blog theme maintained by Dean Attali since 2015, with over 50,000 users.
Jekyll · Blog
jekyll-TeXt-theme
A customizable Jekyll theme for personal sites, team sites, blogs, projects, and documentation.
Jekyll · Blog
startbootstrap-clean-blog-jekyll
The official Jekyll version of Start Bootstrap's Clean Blog theme, offering a blog home page, about page, contact page, and sample post pages, with a Formspree-powered contact form.
Jekyll · Blog
So Simple
A minimal reading-oriented Jekyll theme by Michael Rose for personal blogs, portfolios, and long-form reading. It offers multiple layouts, microformat markup, Disqus comments, Google Analytics, Jekyll SEO Tag, three skins, and aggregation by year, category, and tag with a grid view.
Jekyll · Blog