Remora

Run locally

1. Start the database

docker compose up -d postgres

Uses config/api settings: host 127.0.0.1, port 5432, user postgres, password postgres, database remora_local.

2. Run migrations

ENV=local go run ./cmd/migration

Reads config/migration and runs migrations + seeds against remora_local. If the database does not exist, it is created first (connects to postgres then CREATE DATABASE remora_local).

3. Run the API

ENV=local go run ./cmd/api

Or build then run:

make build app=api
./remora_api

API listens on http://127.0.0.1:8080. Example:

curl http://127.0.0.1:8080/users/{user-uuid}

Requires existing user data (from seed or manual insert).

---

Requirment

go

always use the latest version of go, now is 1.24.4

brew intall go

cocogitto

for Conventional commits command usage

brew install cocogitto

other tools

go install tool

after go install tool, install lefthook git hooks

lefthook install

go-template