{
  "markdown": "# GMC Shelters\n\nA desktop application for managing and publishing the Green Mountain Club's Long Trail shelter archive — photos, records, histories, and metadata — to Google Drive.\n\n---\n\n## The Long Trail & the Green Mountain Club\n\nThe [Long Trail](https://www.greenmountainclub.org/the-long-trail/) is the oldest long-distance hiking trail in the United States. Running 273 miles from the Massachusetts border to the Canadian border along the spine of the Green Mountains of Vermont, it was completed in 1930 and served as the inspiration for the Appalachian Trail.\n\nThe **Green Mountain Club (GMC)**, founded in 1910, built the Long Trail and remains responsible for its maintenance, stewardship, and public access. The GMC is supported by thousands of members, volunteers, and trail crews who keep the path open and safe year-round.\n\n### The Shelter System\n\nAlong the Long Trail, the GMC maintains a network of backcountry shelters — lean-tos, lodges, and cabins spaced roughly a day's hike apart. These shelters give hikers a place to rest, sleep, and take cover from Vermont's notoriously unpredictable weather. Each shelter has its own character and history: some date back to the trail's earliest decades, others have been rebuilt or relocated over the years.\n\nThis application manages the GMC's archive of those shelters: their names, locations, construction details, architectural notes, caretaker histories, and the photo collections that document how each shelter looks and changes over time.\n\n---\n\n## What This App Does\n\nGMC Shelters is the data management tool behind the **[Green Mountain Club Shelter History](https://gmcburlington.org/long-trail-system-shelter-history/)** app on the GMC Burlington website. That public-facing app lets hikers and trail enthusiasts explore the history, photos, and details of every shelter on the Long Trail. This desktop app is how that data is maintained and published.\n\nGMC Shelters is an [Electron](https://www.electronjs.org/) desktop application built for GMC staff to:\n\n- **Browse and edit shelter records** — names, locations, notes, architecture, and associated metadata stored in a local SQLite database.\n- **Manage shelter photos** — bulk upload, review, and organize images linked to individual shelters; EXIF data is extracted automatically.\n- **Publish to Google Drive** — generate a `shelter-manifest.json` from the current database and deploy it alongside shelter photos to a configured Drive folder. Only changed photos (by `updated` timestamp) are re-uploaded; existing Drive file IDs and share links are preserved across publishes.\n- **Track shelter histories** — maintain markdown history files per shelter alongside the database records.\n\nThe app stores all data locally. Google Drive is a publication target, not a source of truth.\n\n**Stack:** Electron 32 · Vite · React 18 · Redux Toolkit · SQLite (better-sqlite3) · TypeScript · MUI\n\n---\n\n## Development\n\n```bash\nnpm install\nnpm start        # dev server (Electron + Vite HMR)\nnpm test         # Jest (main + renderer test projects)\nnpm run lint     # ESLint\n```\n\n---\n\n## Building a Release\n\nThe app uses [Electron Forge](https://www.electronforge.io/) to package and produce platform installers. **Builds must be run on the target platform** — cross-compilation is not supported.\n\n### macOS\n\nProduces a `.dmg` installer.\n\n```bash\nnpm run make\n# Output: out/make/*.dmg\n```\n\nRequires Xcode command-line tools. The app bundle ID is `tech.inulabs.gmc-shelters`.\n\n### Windows\n\nProduces a `.zip` archive containing the packaged app.\n\n```bash\nnpm run make\n# Output: out/make/zip/win32/x64/*.zip\n```\n\nRun from a Windows machine or a Windows CI environment. No additional signing configuration is included by default.\n\n### Linux\n\nProduces a `.zip` archive containing the packaged app.\n\n```bash\nnpm run make\n# Output: out/make/zip/linux/x64/*.zip\n```\n\nRun from a Linux machine. Requires standard build tools (`build-essential` or equivalent).\n\n---\n\n## Release Notes\n\n### v1.0.0 — 2026-05-28\n\nFirst production release. Powers the public [Green Mountain Club Shelter History](https://gmcburlington.org/long-trail-system-shelter-history/) app on the GMC Burlington website.\n\n- Shelter record browser and editor with SQLite-backed storage.\n- Architecture dropdown backed by a dedicated `architectures` database table; legacy values displayed as a selectable option until updated.\n- Photo management: bulk upload, EXIF extraction, per-shelter photo gallery.\n- Shelter histories: per-shelter markdown history files editable in-app.\n- macOS `.dmg`, Windows `.zip`, and Linux `.zip` build targets via Electron Forge.\n",
  "bytes": 4623,
  "sha": "04347d559b44647cbb3a71dd10bd4bcce672eea4ee5766d35737a8c957465938",
  "repo_slug": "john-need/gmc-shelters",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_john_need_gmc_shelters_wiki_index_md_0e17cb5c/readme"
}