Skeleventy gives you a rock solid foundation to build fast and accessible static websites. View the demo site.
- A clean, minimal build pipeline with SCSS and Laravel Mix for compiling assets
- Tailwind added back in for this project
- Gorko, a smart little Sass-powered utility class generator
- Purgecss to remove unused CSS
- HTML minifier
- Supports ES2017 JavaScript, with Babel compilation
- SEO friendly page meta, including Open Graph and Twitter
- Image lazy loading
- Mobile navigation
- XML Sitemap
- Clean and simple blog, with categories and featured images
Node v10+
- Clone the repo
git clone https://github.com/josephdyer/skeleventy.git
cd
into the project folder and runnpm install
- Start the local development server by running
npm run dev
Tip: Eleventy has live reload baked in!
site/
contains all the global data, templates and contentutilities/
contains Eleventy helperfilters
andtransforms
- Each page should have it's own respective folder containing an
index.md
file - You can then choose the most appropriate layout for each page (or create more if you need to)
- The navigation is powered by the official Eleventy navigation plugin
css/
for compiled CSSjs/
for compiled JavaScriptimages/
contains our site's images, an SVG icon sprite and a folder for meta images (OG, Twitter etc)
Laravel Mix gives us a nice API layer on top of Webpack. Skeleventy uses a simplistic set up, but you can take advantage of extending Mix with custom Webpack configurations, code splitting and plugins such as PostCSS, if you so wish.
You'll find the site's uncompiled SCSS and JS within resources/
where Mix will be watching these directories for any changes. Tip: it's best to always restart the server when creating any new partials or folders
scss/
is structured into opinionated sub folders- The
_config.scss
file is where you can change the site's colours and the utility classes generated by Gorko - A typographic scale has already been set up using my personal favourite Major Third scale.
- Tip: for more scales, check out Type Scale
I decided to remove Tailwind in favour of Gorko, purely for its simplicity and maintainability (especially for newer developers). Not having too much to begin with and adding in what you need, will lead to a simpler, more maintainable codebase. Gorko lets you add a sprinkle of reusable utility classes to help keep your code DRY. Credit to Andy Bell for making this handy little tool
utilities/
contains any global utility/helper functionsmodules/
contains your site's actual JavaScript, all kept neat and tidy within their respective modular subfolders- You can import these subfolders into
main.js
usingimport '@modules/example-module'
- Tip: you can set up optional import aliases via the
webpack.mix.js
file
Skeleventy doesn't have responsive images baked in, the main reason being: it's best using CDN. Check out this tutorial on setting up Eleventy with Cloudinary.