Watery is a minimalist, bare-bones theme for the popular JAMstack file-based CMS Jekyll that only uses the
<80kb Water.css framework (hence the name!), while still following the best practices possible for accessibility and search-engine optimization.
I created this because I wasn't able to find an up-to-date starter/skeleton theme for Jekyll. Even the default theme, Minima, uses the large Bootstrap framework.
This project is aimed towards those curious about using Jekyll for the first time, and want to build from as close to scratch as possible. Alternatively, it still has all the features required for creating a hassle-free, informational website or blog in just a few clicks.
As of November 1st, 2020, with >70 posts on Watery, the website scores a perfect 100 in Performance, Accessibility, Best Practices, and SEO on an audit with Google Lighthouse.
New! Change the CSS framework with a single button, thanks to Dropin Minimal CSS.
Despite Watery's minimalist nature, there are a few interesting features that have been added:
_BLANK_config.ymlto make getting up-and-running easy.
_pagescollection for easier organization.
Jekyll requires the following:
See Requirements for guides and details.
gem install jekyll bundler
git clone https://github.com/brennanbrown/watery.git
bundle exec jekyll serve
If you encounter any errors during this process, check that you have installed all the prerequisites in Requirements.
If you still have issues, see Troubleshooting.
Once you have Jekyll up-and-running, there are only a few steps needed to make this theme your own:
_BLANK_config.ymlconfiguration file and replace the current
_postsand start writing your own!
_pagesto however you see fit.
README.mdwith information about your own project or blog.
assetsfolder to customize the site.
assetsfolder, choose another framework to use!
There are several features that I'm still planning to create and integrate, including:
See the open issues for a list of proposed features (and known issues).
Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.
git checkout -b feature/AmazingFeature)
git commit -m 'Add some AmazingFeature')
git push origin feature/AmazingFeature)
Distributed under the MIT License. You can use this project however you see fit without needing to give attribution.
LICENSE for more information.
While creating this theme, I came across a lot of helpful and hard-to-find resources. If you'd like to dive deeper into Jekyll, check them out: