Home

Awesome

gofiber-template

This is an opinionated template for building a RESTful API via HTTP transport project using gofiber/fiber framework, with container support via Docker and CI/CD support via GitHub Actions.

Features

Getting Started

1. Get the template

Use this template button (recommended)

This repository is meant to be used as a template for your own project. You can use the Use this template button on the top right corner of this page to create your own repository from this template.

Clone this repository manually

If you want to clone this repository, you can do so by running the following command:

git clone git@github.com:GalvinGao/gofiber-template.git

2. Configure database URL in .env

DATABASE_URL=postgres://USERNAME:PASSWORD@localhost:5432/DATABASE_NAME?sslmode=disable

More information about database URL can be found in bun's documentation

3. Initialize bun migration & Apply initial migrations

go run main.go db init
go run main.go db migrate

4. Launch

Install gow (optional)

gow stands for Go Watch. It is a tool that watches your Go source code and automatically recompiles and restarts your program when necessary. This allows you to see changes in real time which makes development much easier and faster.

go install github.com/mitranim/gow@latest

Start the server

After you install gow simply replace go with gow and start the server using:

gow run main.go start

Debugging

VSCode

Use the following .vscode/launch.json to launch the application with debugger attached:

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Launch Server",
      "type": "go",
      "request": "launch",
      "mode": "auto",
      "program": "${workspaceFolder}/main.go",
      "args": ["start"]
    }
  ]
}

License

MIT License.

Contributing

Issues and pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.