Skip to content

kylehuntsman/hypermedia-systems

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Hypermedia Systems

Following the web application described in the https://hypermedia.systems book using Golang.

For web developers frustrated with the complexity of modern practice, those looking to brush up on web fundamentals, web development shops looking to bring their apps to mobile, and any workaday programmer looking for an introduction to hypermedia and REST.

Technology Stack

  • Golang as the programming language
  • Fiber as the web framework
  • Go Templates as the server-side templating engine
  • Tailwind CSS for the client side styling
  • HTMX for the client side hypermedia management
  • Air for live reloading

Getting Started

Prerequisites

Running

Running the application via the make or make run command will run the application, generating any missing template files in the process.

$ make

Development

Running

When running the application in development mode, the project uses the Air library for live reloading and is configured to restart the server when any .go or .templ files are changed. The Air reload configuration can be found in the .air.toml file. Air will restart the server by running the make build command and then running the resulting binary.

Run make dev to start the application for development.

$ make dev

Building

Running the make build command will build the application, generating any missing template files in the process. The resulting binary will be placed in the bin directory.

$ make build

Preparing

The project uses Templ as the server-side templating engine. The templates are in the templates directory and are named with the .templ extension. Templ will generate the corresponding *_templ.go files in the templates directory during the prepare step of the build process.

Running the make prepare command will generate any missing template files using Templ. The generation command is run automatically when running or building the application via make, make run, make dev, or make build.

$ make prepare

Cleaning

Running the make clean command will remove any generated files, including the bin directory and all generated template files.

$ make clean

About

Following the web application described in the https://hypermedia.systems book using Golang.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published