[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-84040":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":15,"stars7d":16,"stars30d":16,"stars90d":15,"forks30d":15,"starsTrendScore":16,"compositeScore":17,"rankGlobal":10,"rankLanguage":10,"license":18,"archived":19,"fork":19,"defaultBranch":20,"hasWiki":21,"hasPages":19,"topics":22,"createdAt":10,"pushedAt":10,"updatedAt":26,"readmeContent":27,"aiSummary":10,"trendingCount":15,"starSnapshotCount":15,"syncStatus":16,"lastSyncTime":28,"discoverSource":29},84040,"atlas","dawarich-app\u002Fatlas","dawarich-app","Your favorite offline self-hostable maps. City, Country, Planet, you choose.","https:\u002F\u002Fatlas.dawarich.app",null,"Elixir",99,5,1,0,2,2.33,"GNU Affero General Public License v3.0",false,"main",true,[23,24,25],"maps","osm","self-hosted","2026-06-12 02:04:37","# Dawarich Atlas\n\nA local-first, self-hostable maps stack. Built on OpenStreetMap data and FOSS components, designed to run on hardware you control with zero outbound API calls at runtime.\n\nAtlas is the maps engine that powers Dawarich, packaged so it stands on its own — install it on your own box, plug your own clients into the API.\n\n## Screenshots\n\n| Search | Routing |\n|---|---|\n| ![Search panel with Photon results over MapLibre](images\u002Fatlas-search.png) | ![Routing panel with Valhalla directions](images\u002Fatlas-routing.png) |\n| **POIs** | **Settings** |\n| ![POI category picker over Overpass results](images\u002Fatlas-pois.png) | ![Admin Settings tab: regions, services, basemap](images\u002Fatlas-settings.png) |\n\n## Quickstart\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fdawarich-app\u002Fatlas.git\ncd atlas\ndocker compose up -d\n```\n\nThat's it — no `.env` file required. The app auto-generates a `SECRET_KEY_BASE` on first boot (persisted to `data\u002Fapp\u002F.secret_key_base`) and stores its data in a local SQLite file under `data\u002Fapp\u002F`.\n\nVisit [http:\u002F\u002Flocalhost:8484](http:\u002F\u002Flocalhost:8484). The map page is live as soon as Caddy and Atlas come up. Open the **Settings** tab in the side panel to toggle Search \u002F Routing \u002F POIs \u002F Transit and pick the active region. Save & apply — the sidecar handles downloads and ingest, with progress streaming back over Action Cable.\n\nTo pin a specific region preset up front (instead of picking in the UI), copy one into `.env` before booting:\n\n```bash\ncp regions\u002Fberlin.env .env\ndocker compose up -d\n```\n\nSee [`.env.example`](.\u002F.env.example) for the optional overrides (custom `SECRET_KEY_BASE`, external Postgres via `DATABASE_URL`, admin credentials, basemap URL).\n\nCity scale boots in minutes; country takes hours of background ingest; planet takes days.\n\n**[Full walkthrough →](https:\u002F\u002Fatlas.dawarich.app\u002Fdocs\u002Fquickstart)**\n\n## Documentation\n\nEvery operational topic has a dedicated page on the website. The README is intentionally thin — anything that's not in the table below lives there.\n\n| Topic | Where to read |\n|---|---|\n| What it is, capability list, response envelope | [Introduction](https:\u002F\u002Fatlas.dawarich.app\u002Fdocs\u002F) |\n| Clone → boot → data layers, admin panel auth, offline basemap | [Quickstart](https:\u002F\u002Fatlas.dawarich.app\u002Fdocs\u002Fquickstart) |\n| Design principles, tech stack, topology, Go sidecar, Nominatim decision | [Architecture](https:\u002F\u002Fatlas.dawarich.app\u002Fdocs\u002Farchitecture) |\n| Region presets, multi-region auto-merge, scaling tables (Germany \u002F France \u002F USA \u002F planet) | [Regions](https:\u002F\u002Fatlas.dawarich.app\u002Fdocs\u002Fregions) |\n| Compose profiles, graceful degradation, ports | [Compose profiles](https:\u002F\u002Fatlas.dawarich.app\u002Fdocs\u002Fcompose-profiles) |\n| Full OpenAPI spec (Redoc-rendered) | [Public API](https:\u002F\u002Fatlas.dawarich.app\u002Fapi\u002Fv1\u002F) · [Admin API](https:\u002F\u002Fatlas.dawarich.app\u002Fapi\u002Fadmin\u002F) |\n\nDocs source: [`dawarich-app\u002Fatlas-website`](https:\u002F\u002Fgithub.com\u002Fdawarich-app\u002Fatlas-website).\n\n## CI \u002F images\n\nThe app is the Phoenix application in [`app-phoenix\u002F`](app-phoenix\u002F). It serves\nthe map UI, admin Settings, the public + admin JSON APIs, and the control plane\n(the former Go `atlas-control` sidecar is absorbed into it — Phoenix execs\n`docker compose` against the host daemon directly). CI runs on GitHub Actions\n(`.github\u002Fworkflows\u002F`):\n\n| Job | Trigger | Output |\n|---|---|---|\n| `test-phoenix` | push \u002F PR touching `app-phoenix\u002F**` | `mix test --include parity` (incl. byte-diff parity gate against the Rails goldens) + `credo` |\n| `build-app` | push to `main` touching `app-phoenix\u002F**` | `ghcr.io\u002Fdawarich-app\u002Fatlas\u002Fapp:latest` + `:\u003Csha>` (multi-arch amd64+arm64) |\n| `test-rails` | push \u002F PR touching `app\u002F**` | RSpec — the legacy Rails app (`app\u002F`) is retained only as the parity reference for the golden capture; it is no longer built or shipped |\n\nCompose defaults consume the `app` tag directly — `docker compose up -d` against a fresh checkout pulls from GHCR with no auth.\n\nOverride the image when iterating locally:\n\n```bash\nAPP_IMAGE=atlas-app:dev docker compose build app\nAPP_IMAGE=atlas-app:dev APP_PULL_POLICY=never docker compose up -d\n```\n\n## Development\n\n- Phoenix app (the shipped app): [`app-phoenix\u002FREADME.md`](app-phoenix\u002FREADME.md)\n- Legacy Rails app (parity reference only): [`app\u002FREADME.md`](app\u002FREADME.md)\n\nEnd-user documentation source lives in the separate [atlas-website repo](https:\u002F\u002Fgithub.com\u002Fdawarich-app\u002Fatlas-website) — open PRs against the docs there.\n\n## License\n\nDawarich Atlas is licensed under the **GNU Affero General Public License v3.0** ([LICENSE](.\u002FLICENSE)) — the same license as Dawarich. Anyone running Atlas as a service must publish their modifications under the same license.\n\nUpstream components retain their own licenses: OSM data is ODbL; Protomaps and MapLibre are BSD-3; Valhalla is MIT; Photon, Overpass and OpenTripPlanner are LGPL-3.0 or AGPL-3.0; Rails is MIT.\n","2026-06-11 04:12:10","CREATED_QUERY"]