- docs: move server docs to docs/server/ and update all cross-references - docs: move web-roadmap.md to docs/web/roadmap.md and create docs/web/decisions.md - docs: update AGENTS.md with separate Server and Web sections
1.8 KiB
Development
Prerequisites
- Go 1.26.2 (pinned in
mise.toml) mise(https://mise.jdx.dev) — runmise installto install toolchain
Build
go build ./...
go build -o mygo .
Test
go test ./...
go test -v -run TestName ./internal/...
Lint & Format
go vet ./...
go fmt ./...
Repository Review
Use the repository-scoped $mygo-api-repo-review skill for evidence-based architecture, design, security, resilience, data-consistency, performance, and implementation audits. Reviews are read-only unless fixes are requested separately.
Select one review mode:
diffcompares the current workspace, including relevant untracked files, withHEAD.maincompares the current workspace with the merge base ofHEADand the localmainbranch without fetching remote refs.fullreviews the current repository as a whole.
Optionally limit any mode to a target path, Go package, or logical component. For example:
Use $mygo-api-repo-review in main mode with target internal/storage.
Dependencies
go mod tidy # after adding/removing imports
Config
Server config is loaded via viper from config.yaml (defaults in internal/config/load.go).
server:
host: 0.0.0.0
port: 10086
database:
driver: sqlite3
sqlite:
path: data/mygo.db
storage:
driver: local
local:
path: data/files
jwt:
secret: dev-secret-do-not-use-in-production
access_ttl: 15m
refresh_ttl: 168h
Environment variables use MYGO_ prefix with underscore separators: MYGO_SERVER_PORT=8080, MYGO_JWT_SECRET=...
The default JWT secret is a development placeholder. At startup, MyGO replaces
it with an ephemeral runtime secret; set a stable jwt.secret or
MYGO_JWT_SECRET when tokens must survive restarts or when running multiple
instances.