Development

​

Prerequisites

• Go 1.26+
• git
• make available in your shell

​

Clone repository

git clone https://github.com/hyperlocalise/hyperlocalise.git
cd hyperlocalise

​

Bootstrap tools and modules

make bootstrap

​

Daily development loop

make fmt
make lint
make test
make check-build

​

Run the CLI locally

make run
# or
go run -ldflags "-X main.version=dev" ./apps/cli

​

Install local binary

make install
hyperlocalise version

​

Key code locations

• apps/cli/cmd/: Cobra commands, flags, and CLI output behavior
• pkg/i18nconfig/: i18n.yml and i18n.jsonc parsing and validation
• apps/cli/internal/i18n/runsvc/: run planning and execution flow
• apps/cli/internal/i18n/syncsvc/: sync orchestration and conflict logic
• internal/i18n/storage/: adapter contracts and provider integrations

​

Before opening a PR

make precommit