Installation

Get started with goilerplate in minutes

Prerequisites

  • Mac, Linux, or Windows (via WSL)
  • Go 1.25+
  • Task
  • TailwindCSS CLI
  • An S3-compatible storage account (Cloudflare R2 recommended, 10GB free)
  • Docker, only if you want to run PostgreSQL locally (SQLite is the default and needs nothing)

Note: Development tools like templ are automatically installed via Go 1.25’s tool directive.

Quick Start

git clone https://github.com/templui/goilerplate.git
cd goilerplate
cp .env.example .env

Open .env and add your S3 credentials. We recommend Cloudflare R2 (10GB free, zero egress), but any S3-compatible provider works. See Storage for the 1-minute setup.

Then:

task dev

Open http://localhost:7331.

task dev automatically downloads Go deps, installs dev tools (templ), generates templates, builds CSS, and starts the server with hot reload.

Next Steps

← IntroductionConfiguration →