This is the Agency Bootstrap theme converted to a gem-based Jekyll theme with GitHub Pages support. While this had been done before, (here, here, and here), these are outdated and have not been updated or maintained for years. I built this theme from the most recent Bootstrap source. I also added a lot of new features that go beyond the original theme’s capabilities:

Features

  • GitHub Pages support
  • template repo to get up and running in minutes
  • contact form functionality powered by Formspree.io
  • custom pages
  • 404 page
  • legal/Privacy Policy page
  • Google Analytics support
  • Markdown support
  • custom images
  • logo support (instead of just title text)
  • automatically updating copyright years
  • custom navigation bar, even without the header image(s)
  • customizable footer
  • custom accent color and dark/light colors
  • horizontal scrolling support for client section

Installation

There are three ways to install this theme:

  1. As a gem-based theme
  2. Use the starter template (best for GitHub Pages)
  3. As a remote theme

1. Gem-based Theme Installation

Add this line to your Jekyll site’s Gemfile:

gem "jekyll-agency"

Then, replace the contents of your _config.yml file with this.

And then execute:

$ bundle

Or, install it yourself as:

$ gem install jekyll-agency

2. Using the Starter Template

This is the fastest and easiest way to get up and running on GitHub Pages. Simply generate your own repository by clicking here, then replace the sample content with your own and configure for your needs.

3. Remote Theme Installation

Replace the contents of your _config.yml file with this and your Gemfile with this. Then execute:

$ bundle

Improvements - Up for Grabs

  • multiple language support
  • custom background images

Development

To set up your environment to develop this theme, clone this repo, then run bundle install. To test the theme, run bundle exec jekyll serve and open your browser at https://localhost:4000. Add pages, documents, data, etc. like normal to test the theme’s contents. As you make modifications, your site will regenerate and you should see the changes in the browser after a refresh, just like normal.

Contribute

This project is intended to be a welcoming space for collaboration. If you have an idea, suggestion, feature request, etc., feel free to open an issue or pull request. For bug reports, follow the provided template.

Support

If you enjoy this theme, please consider supporting me to continue developing and maintaining it.