Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/aaron-smits/go-templ-starter

demo project for Go with HTMX/templ/Supabase/Tailwind
https://github.com/aaron-smits/go-templ-starter

cicd docker github-actions go golang htmx make postgres postgresql tailwind tailwindcss

Last synced: about 1 month ago
JSON representation

demo project for Go with HTMX/templ/Supabase/Tailwind

Awesome Lists containing this project

README

        

# go templ starter

This is a demo project to show how to create a full stack web application using Go, Echo templ, HTMX, Supabase, Postgres and Tailwind CSS.

We use the following tools:

| Category | Technology |
| -------------- | -------------------------------------------------------------------------- |
| Language | [Go](https://golang.org/) |
| Web Framework | [Echo](https://echo.labstack.com/) |
| Templating | [templ](https://github.com/a-h/templ) |
| JavaScript | [HTMX](https://htmx.org/) |
| CSS | [Tailwind CSS](https://tailwindcss.com/) |
| Database/Auth | [Supabase](https://supabase.com/), [PostgreSQL](https://www.postgresql.org/) |
| Build Tools | [Docker](https://www.docker.com/), [Make](https://www.gnu.org/software/make/), [GitHub Actions](https://docs.github.com/en/actions) |

## Getting Started

### Prerequisites

- [Docker](https://www.docker.com/)
- [Make](https://www.gnu.org/software/make/)
- [Go](https://golang.org/)

### Installation

1. Clone the repo

```sh
git clone https://github.com/aaron-smits/go-templ-starter.git
```

2. Set environment variables

```sh
cp .env.dev.example .env
```

3. Start the database and the app with docker compose

```sh
make docker
```

## todo

### p0

- [ ] Light/dark modes

### p1

- [ ] Write unit tests for other packages besides the db package

### p2

### p3