Skip to content
tellbowPublic

About

Hiking companion

Topics

Resources

Contributing

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Repository files navigation

Alvyo

Plan, share and walk hikes in Switzerland — custom routes on the swisstopo national map, official Swiss hiking times, SAC difficulty, and multi-week stage journeys.

Status: early development. What works, in short (details, status and what comes next: docs/plan.md; deployment: docs/operations.md, restoring it: docs/restore.md):

  • Planning: routes on the swisstopo map with Swiss hiking time (matching SchweizMobil), SAC grade, elevation profile, weather, closures and how far one gets in 2, 4 and 8 hours.
  • Journeys: multi-week stage journeys planned from start, destination and days, with huts for the nights and public transport.
  • Sharing and community: public, by link or invitation; collections, a discovery map, friends, a feed, likes, comments and photos.
  • App: iOS, with the national map offline, spoken navigation, recording, an Apple Watch app and the Watch's hikes imported (app/README.md).
  • AI assistants and the command line: an MCP server and alvyo-cli with a personal access token, read-only (docs/mcp.md).
  • Data and privacy: GPX export, import from GPX, KML, TCX and FIT, privacy zones; in German, English, French and Italian.

Screenshots

Planner with a route and its elevation profile
Planning a route
A route's page with its numbers, weather and trail conditions
A route's page
A journey with two stages
A journey and its stages
Areas reached within 2, 4 and 8 hours from Kandersteg
How far one gets («Reichweite»)
The discovery map of public hikes
Discovering public hikes
A route in the iOS app Navigation in the iOS app
The app: a route, navigating

Layout

Path What
swiss/ Go module: Swiss domain logic (hiking time, SAC, LV95, elevation, OJP)
api/ Go module: HTTP API (alvyo binary)
web/ SvelteKit web app
app/ Flutter app (iOS)
infra/ Docker Compose, GraphHopper, tile cache, data import
docs/ Plan, ADRs, hiking-time calibration, development and operations

How the parts fit together: docs/architecture.md.

Development

Needs Go 1.26, bun and Docker. Setup, daily workflow, tests and a production-like local run: docs/development.md.

make osm-fetch && make infra-up          # once: map data + containers
export ALVYO_DATABASE_URL='postgres://alvyo:alvyo@localhost:5432/alvyo?sslmode=disable'
go run ./api/cmd/alvyo migrate && go run ./api/cmd/alvyo serve
cd web && bun run dev                    # → http://localhost:5173

License

AGPL-3.0-only — see LICENSE. Third-party data and code attributions: NOTICE. Terms of every data source and where each is credited: docs/licensing.md. Contributions: CONTRIBUTING.md (with a CLA).

About

Hiking companion

Topics

Resources

Contributing

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages