Skip to content

Add design principles section to README#116

Merged
jasoneplumb merged 1 commit intomainlinefrom
feature/110-design-principles
Apr 18, 2026
Merged

Add design principles section to README#116
jasoneplumb merged 1 commit intomainlinefrom
feature/110-design-principles

Conversation

@jasoneplumb
Copy link
Copy Markdown
Owner

Summary

Adds a new Design Principles section to the README between Features and Tech Stack that outlines the six core architectural decisions:

  • Offline-first — App works without connectivity; all tiles cached, no required server calls
  • Local-only data — No server storage, no accounts, no telemetry — your trail stays on your device
  • Progressive enhancement — Core features work everywhere; advanced features activate when APIs available
  • Mobile-native UX — Bottom sheets, safe-area insets, touch controls, and responsive layouts built in
  • Minimal dependencies — No framework, no CSS library, no state management — just Leaflet, ESRI Leaflet, and a 400-line app
  • Transparent architecture — Single AppState object, explicit data flow, no event bus or indirection

These principles are verified against the actual codebase patterns and dependencies.

Closes #110

Adds a new Design Principles section between Features and Tech Stack that outlines
the six core architectural decisions driving the project:
- Offline-first design with cached tiles
- Local-only data, no server storage or tracking
- Progressive enhancement with graceful API fallbacks
- Mobile-native UX with bottom sheets and touch controls
- Minimal dependencies (Leaflet + ESRI only)
- Transparent architecture with single shared state

Closes #110

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
@jasoneplumb jasoneplumb added the enhancement New feature or request label Apr 18, 2026
@jasoneplumb jasoneplumb merged commit d343409 into mainline Apr 18, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add design principles section to README

1 participant