Goath-stack-template

A modern web stack template powered by Golang, Templ, TailwindCSS, Alpine.js, and HTMX.

This project serves as a starter template that helps you quickly bootstrap your development. Simply replace goath-stack with your own project name, and you’re ready to go.

---

Features

• 🚀 Golang + Templ: Type-safe template engine with enhanced HTML componentization.
• 🎨 TailwindCSS v4: A utility-first and elegant CSS framework.
• 🌈 DaisyUI: A beautiful, themeable component library built on top of TailwindCSS.
• ⚡ Alpine.js: Lightweight JavaScript for interactivity.
• 🔗 HTMX: Build interactive frontends with minimal JavaScript.
• 🐳 Docker Support: Works for both local development and containerized environments.

---

Installation

Install gonew

go install golang.org/x/tools/cmd/gonew@latest

Create a new project with gonew

gonew github.com/dachichang/goath-stack-template your-project-name

Project Initialization

1. make init will init entire project necessary modifies.
2. Replace the OpenAPI annotations goath-stack in the main.go with your own project name.

---

Local Development

make run / make clean

• make run installs the required dependencies and uses air for automatic build of the project.
• The generated binary will be placed under the tmp directory.
• The default port is 3000, but you can adjust it in the .env file.

make up / make log / make down

• make up starts the entire local development environment using docker compose.
• Everything runs fully inside Docker, ensuring a 100% clean environment.
• When you exit the container, all builds and node_modules will not be preserved.
• The default port is 8080, but you can adjust it in the docker-compose.yaml file.
• Use make log to monitor containers running status and logs.
• It is recommended to use Docker for development to keep your local system clean.

Run in Docker

make docker-image / make docker-run

• make docker-image will automatically build the local Docker image, and once completed, it can be executed immediately.
• make docker-run will start the image generated by make docker-image, expose port 3000, and load the .env environment variables.
• Note: If you are not using the default port 3000, you will need to adjust both the Makefile and .env to ensure they match.