gothat

README

GOTHAT

GOTHAT is a highly opinionated framework for building progessive web applications.

It differentiates itself from most “modern” SPA web frameworks in that:

• it does not utilize a large, JavaScript based framework as its core,
• it is Server Side Rendered, using GO and Templ to render HTML,
• it uses htmx to render and replace portions of the DOM easily,
• it uses AlpineJS for easier, concise JavaSCript for user interactions,
• it uses TailwindCSS (currently v3.x) which is the least unusual aspect,
• and finally, it compiles to a single binary, making it very easy to deploy.

GOTHAT derives its name from the five main elements of the technology stack:

GO Templ Htmx Alpinejs Tailwindcss

Modularized

GOTHAT is highly modularized, and is meant to be the core of a larger "modul-ithic" project.

Individual packages, see weather, allow dev teams to independently create, maintain and own portions of a bigger system.

Usage

Make a copy of .env-example, as .env.

OWM_API_KEY is only needed if using the weather package, and can be removed otherwise.

run:

go mod tidy

then run:

make dev

Available MAKE commands

             this is your main command
dev          run all three below, in watch mode, combined

templ        run templ generate in stand alone mode
templw       run templ generate in watch mode with proxy

css          run tailwind in stand alone mode
cssw         run tailwind in watch mode

air          run air, hot reloading of GO application

build        build GO application for linux

update/air   install or update air https://github.com/air-verse/air
update/templ install or update templ https://templ.guide/