go-on-rails

README

Go on Rails / Rails for Go

A starter kit for Go, not a framework, resembling patterns found in Rails and other MVC frameworks.

What I mean to do here is speed up web app development in Go, by providing a set of tools and patterns that are familiar to developers coming from other languages and frameworks.

I am also highly opinionated against thick clients.

If you like Go, Docker, HTMX, Templ, and Tailwind, then you might enjoy this project and find value in it.

How to use

1. Clone this repository
2. Run make dev to start the development server
3. Open your browser at http://localhost:3000

How to deploy

1. Clone this repository
2. Build the Docker image with docker build -t yourapp .
3. Run the Docker container with docker run -p 8080:8080 yourapp

Alternatively, you can write a docker-compose.yml file and use it to deploy your app. This is not included here because you may likely use one for multiple services, not just this one.

What's included

We included examples of:

• how session-based authentication can be implemented in Go, see the auth models, controllers, and views.
• CRUD operations under auth; see the posts models, controllers, and views where users can create, read, update, and delete posts.
• user permissions, payments integration & file uploads/downloads in an eCommerce context; see the commerce models, controllers, and views.
• analytics dashboard that shows how to 1. track user interactions 2. use HTMX to update the UI; see the analytics model, controller, and views.