Just push to Github: Build static pages continuously using PHP generators like Jigsaw on Netlify

(Edit: 19–01–12: I will not update this post on Medium on longer. You can always find the latest version of it over here on my website)

Jigsaw is a very lean static page generator and especially easy to learn for everyone familiar with Laravel and its blade templating language.

netlify is a fantastic host for static pages with a generous free tier and nice tooling.

One of the coolest features is Continuous Deployment: You create and preview your site locally, commit changes to your Git repo — and Netlify builds static pages using their build image.

Node, Ruby and Python based tools have been well supported for a long time, but PHP just got first class support lately: Netlify’s Bryce Kahle updated PHP to version 7.2, improved composer support and made sure that essential extensions like mbstring are in the base image.

Thanks to these changes, it is now super easy to have a continuous Jigsaw (PHP) build that reacts to commits to your Github, Gitlab or Bitbucket repos.

Let me walk you through an example site (see: minthemiddle/jigsaw-netlify-test):

Install Jigsaw locally.

As I have had problems installing Jigsaw globally, I always install it locally

  • $mkdir jigsaw-netlify-test

Set up Git

  • Put your project folder in a git repo via git init

Set up Netlify page

  • Log into your Netlify account and create New site from Git

Create deployment script

Netlify needs to know how to build your site. You can tell it by creating a netlify.toml config file:

This will use PHP7.2, run gulp which will compile assets and build your site using Jigsaw and deploy the static page to the /build_production folder from where Netlify publishes it to the web.

Deploy

Try it out:

  • Make some changes in your local Jigsaw page in the /source folder.

Speed it up

  • I found out that yarn takes about 2 minutes to install itself and all dependencies in Netlify’s image

netlify.toml

Originally published at gist.github.com.

martinbetz.eu, Product owner, programmer, AB tester — Berlin/Germany

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store