wolfeidau/hotwire-golang-website

This project provides some working examples using Go and Hotwire Turbo.

hotwire-golang-website

This project provides some working examples using Go the hotwire/turbo library published by basecamp. This is based on a great post about Hotwire: HTML Over The Wire by @delitescere.

Overview

This service illustrates how to use turbo to enable updates to a website using primarily service side code.

1. Uses html/template via my helper library echo-go-templates which provides layout helpers, and embedded assets with io/fs for views.
2. Uses echo library to simplify routing.
3. Uses a CDN to host all css / JS libraries base.html.
4. Uses esbuild to automatically bundle JS assets on startup using echo-esbuild-middleware to serve them.

Hotwire Turbo

In this site I have implemented:

1. Turbo Drive
2. Turbo Frames
3. Turbo Streams with Server Sent Events (SSE) and WebSockets
4. stimulus

Most of the server side logic is in hotwire.go.

Prerequisites

• Go 1.13 or later with support for Go Modules, used to build the service.
• Node.js 12 or later, which is only used to install our asset building dependencies.

Running

To get this project running you need to setup some certificates, in my case I use https://github.com/FiloSottile/mkcert and there is a target in the makefile.

make certs

To install node dependencies

make install

To start the service just run.

make start

For development you can use the following command, this will check for code updates and restart the service.

make watch

The service should be listening on https://hotwire.localhost:9443/

License

This application is released under Apache 2.0 license and is copyright Mark Wolfe.

hotwire-golang-website's Issues

npm install

Are we supposed to CD into the /assets dir and run npm install?

I'm getting this error:

FTL failed to build assets errors=[{"Detail":null,"Location":{"Column":27,"File":"assets/src/controllers/clipboard_controller.ts","Length":16,"Line":1,"LineText":"import { Controller } from '@stimulus/core'","Namespace":""},"Text":"Could not resolve \"@stimulus/core\" (mark it as external to exclude it from the bundle)"},{"Detail":null,"Location":{"Column":28,"File":"assets/src/index.ts","Length":16,"Line":1,"LineText":"import { Application } from \"@stimulus/core\"","Namespace":""},"Text":"Could not resolve \"@stimulus/core\" (mark it as external to exclude it from the bundle)"}]

Thanks!

Your opinion

Hi. What is Your opinion about hotwire + go after time? Is it worth to try? Nice code!

cannot load embed: malformed module path "embed": missing dot in first path element

Hi!

If I run make start then I get this error:

...
go: finding golang.org/x/text v0.3.3
go: finding github.com/rs/zerolog v1.20.0
go: finding github.com/wolfeidau/echo-middleware v1.1.0
build command-line-arguments: cannot load embed: malformed module path "embed": missing dot in first path element
make: *** [start] Error 1

Any idea why this fails?