templ_ui_library

Templ UI Library

Material UI components for Go web applications using the templ templating engine, htmx and Tailwind CSS.

Prerequisites

• Go 1.21 or later
• templ CLI tool
• Docker (optional, for containerization)

Getting Started

1. Clone this repository:

   git clone https://github.com/MathisVerstrepen/htmx_templ_template.git
   cd htmx_templ_template
   

2. Install dependencies:

   go mod tidy
   

3. Install Air for live reload:

   go install github.com/air-verse/air@latest
   alias air="~/go/bin/air"
   

4. Install templ CLI tool:

   go install github.com/a-h/templ/cmd/templ@latest
   

5. Install tailwind dependencies:

   npm install
   

6. Run the development server:

   air
   

7. Open your browser and navigate to http://localhost:4269

Project Structure

.
├── assets
│   └── css
│   └── favicon
│   └── images
├── components
├── handlers
├── models
├── services
├── ui
├── main.go
├── Dockerfile
├── go.mod
├── go.sum
└── README.md
└── .air.toml
└── .env

Development

• Use air to start the development server with live reload.
• Add new routes in main.go.
• Create handlers in the /handlers directory.
• Add templ components in the /components directory.

Building for Production

1. Build the binary:

    go build -o bin/server
   

2. Run the production server:

    ./bin/server
   

Docker Support

Build the Docker image:

docker compose build

Run the container:

docker compose up

License

This project is licensed under the MIT License - see the LICENSE file for details.