Skip to content

PylotLight/wails-htmx-templ-template

Repository files navigation

README

About

This template uses a unique combination of pure htmx for interactivity plus Go templates for creating components and forms, also included:

  • Built-in added styling to show off some of Tailwind and Daisyui.
  • Uses HTMX for MPA style interactivity on a single page as per SPA.
  • Added custom Chi middleware for handling HTMX calls in an easy to maintain routing configuration.
  • Built-in version display linked to version variable from main which can be updated on app build for CICD and/or during runtime.
  • Scripts configured to use the Bun runtime to launch Vite. (Make sure you have bun installed first)
  • To switch back to npm instead of bun, edit wails.json and package.json
  • Also using https://templ.guide/ for components and templates use "templ generate" to update templ files.

Initial Setup Instructions

  • Install Bun
  • Change go.mod module
  • Change app.go components package import
  • For Linux build tag webkit2_40 is required e.g -tags webkit2_40

Live Development

To run in live development mode, run wails dev in the project directory. In another terminal, go into the frontend directory and run bun run dev. The frontend dev server will run on http://localhost:34115. Connect to this in your browser and connect to your application.

Building

To build a redistributable, production mode package, use wails build.