htmgo/README.md

43 lines
1.6 KiB
Markdown
Raw Normal View History

2024-09-20 18:40:38 +00:00
## **htmgo**
### build simple and scalable systems with go + htmx
-------
2024-09-29 14:07:13 +00:00
[![Go Report Card](https://goreportcard.com/badge/github.com/maddalax/htmgo)](https://goreportcard.com/report/github.com/maddalax/htmgo)
2024-09-30 14:24:06 +00:00
![Build](https://github.com/maddalax/htmgo/actions/workflows/run-framework-tests.yml/badge.svg)
2024-09-20 18:40:38 +00:00
**introduction:**
htmgo is a lightweight pure go way to build interactive websites / web applications using go & htmx.
By combining the speed & simplicity of go + hypermedia attributes ([htmx](https://htmx.org)) to add interactivity to websites, all conveniently wrapped in pure go, you can build simple, fast, interactive websites without touching javascript. All compiled to a **single deployable binary**.
```go
func IndexPage(ctx *h.RequestContext) *h.Page {
now := time.Now()
return h.NewPage(
h.Div(
h.Class("flex gap-2"),
h.TextF("the current time is %s", now.String())
)
)
}
```
**core features:**
1. deployable single binary
2. live reload (rebuilds css, go, ent schema, and routes upon change)
3. automatic page and partial registration based on file path
4. built in tailwindcss support, no need to configure anything by default
2024-10-21 15:35:42 +00:00
5. custom [htmx extensions](https://github.com/maddalax/htmgo/tree/b610aefa36e648b98a13823a6f8d87566120cfcc/framework/assets/js/htmxextensions) to reduce boilerplate with common tasks
2024-09-20 18:46:31 +00:00
**get started:**
2024-09-24 20:10:08 +00:00
View documentation on [htmgo.dev](https://htmgo.dev/docs).
2024-10-15 16:25:06 +00:00
## Star History
[![Star History Chart](https://api.star-history.com/svg?repos=maddalax/htmgo&type=Date)](https://star-history.com/#maddalax/htmgo&Date)