/muxt-template-module-todo

Primary LanguageGoThe UnlicenseUnlicense

A Simple MUXT Project Template using HTMX

This is an example muxt hypertext server. See this article for how to use this template: https://go.dev/blog/gonew.

It is based on https://github.com/crhntr/muxt-template-module-htmx. You may also want to see:

  • HTMX: configured for site interactivity
  • Pico CSS: configured to make the site look a bit better by default
  • counterfeiter: used to generate fake Server implementations for testing templates
  • unpkg.com: use the meta query param to get new version integrity values

It extends the module by using sqlc to for database interactions with PostgreSQL.

  • sqlc: to generate type safe database interactions
  • pqx: for a database driver
  • goose: for migrations

Developing

Add new html in ./internal/hypertext/templates. Use inline template declarations in the template files using muxt template name semantics then run Go generate to generate a function that maps hypertext concepts to helpful handler methods.

Testing

After developing routes, run go generate ./....

Write handler tests in ./internal/hypertext/server_test.go.

Write template tests in ./internal/hypertext/template_routes_test.go.

Run tests with: go test ./...

Database

Set the database URL with the environment variable DATABASE_URL.