Skip to main content

​
Prerequisites

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

​
Clone repository

git clone https://github.com/quiet-circles/hyperlocalise.git
cd hyperlocalise

​
Bootstrap tools and modules

make bootstrap
This downloads Go modules and installs the pinned lint toolchain.

​
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" main.go

​
Install local binary

make install
hyperlocalise version

​
Key code locations

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

​
Before opening a PR

make precommit
This runs formatting, linting, tests, and build checks in the same flow used by contributors.