Website and blog generator in Go, Node.js or Python
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
deploy Support both 301 and 302 in Sep 27, 2017
themes Default theme dark mode support Oct 28, 2018
.gitignore Support all task.cfg properties as CLI options Oct 29, 2017
LICENSE Add LICENSE file Aug 26, 2017
content.json Update example feed locations Oct 29, 2018
task Support arguments for ./task watch Nov 6, 2017


Minimal is a static personal website and blog generator for Go, Node.js and Python. It has no external dependencies and requires only a few hundred lines of code to run. Everything is minimal, easy to take appart and rewrite.

Example blogs are hosted on Netlify using the default, profile and developer themes.

Getting Started

To get started, fork this repository and create a local clone.

Modify ./content.json to your liking (symbol codes for social links can be found here).

To build locally and launch a simple web server run either of the following:

  • Install Node.js and run ./task start --runtime node.
  • Install Go and run ./task start --runtime go.
  • Install Python and run ./task start --runtime python.

The default runtime can be configured via ./task.cfg.


To deploy to a production enviroment set the deploy target in ./task.cfg and update the corresponding .cfg file in the ./deploy folder, then run ./task deploy to build and deploy the site.

To host the repository on Netlify set the target to netlify. In your site settings (Settings > Build & Deploy > Continuous Deployment) update Build Command to ./task deploy and Publish Directory to build.