letsgo

letsgo

A tool to help build go web applications quickly.

Running this will create a go app with a Postgres database for local development, all in Docker containers.

Usage

Prerequisites

letsgo requires Go 1.23 or higher installed. letsgo also assumes that docker compose will run with a reasonably up to date version.

Building

After cloning the repository, run make build to build, then move letsgo to somewhere in your path.

Usage

Generating a project

letsgo make $projectname $projectRepository Example: letsgo make something-cool github.com/nmusey/something-cool

Everything is Dockerized so you shouldn't have to install any dependencies locally.

New packages

letsgo make $package Example: letsgo make product

Adding templating

letsgo uses templ for templating. Hot reloading with Air is enabled by default. letsgo templ && templ generate

Migrations

letsgo uses migrate for database migrations. By default these are run when you POST /migrate. This is convenient for local development but should be migrated when moving to production.

migrate is not necessary locally but is preferred. You can always make migrations by copying the default files, but installing and running the tool is easier.

Future Features

• Support for other databases is not planned right now
• Support for other frameworks is not planned right now