TODOx is a todo list app built with Go, HTMX, Tailwind CSS and SQLite to store the data. The original goal of this app is to try HTMX and see how it can be used to build a simple app.
- Create, Read, Update, and Delete TODOs
- Searching TODOs
- Complete/Reopen TODOs
The stack aims to be as simple as possible. It consists of:
- Go is the main language.
- HTMX for the interactions with the user.
- Tailwind CSS with the Standalone CLI for styling.
- SQLite as the database.
The application is mostly written in Go and HTML. HTMX facilitates a lot of the interaction with the user on the frontend and the backend endpoints process requests and return HTML that will be then rendered by HTMX.
The Tailwind CSS Standalone CLI takes care of the styling by processing html files and adding resulting CSS to internal/app/public/styles.css. Any CSS in the public folder is served by the Go server. The storage of the application is SQLite.
In order to install the app in development you should download the tailwind css standalone CLI and air for hot reloading. You can do this by running the following command:
go run ./cmd/setup
To run the app in development you can run the following command:
go run ./cmd/dev
And visit http://localhost:3000 to see the app running.
The app contains a Dockerfile that can be used to build images and deploy to any container platform.
A few environment variables to consider are:
GO_ENV - The environment the app is running in. Defaults "development"
PORT - The port the app will run on. Defaults "3000"