🏪 711 Samui Map
Find all 7-Eleven stores on Koh Samui with one tap
Interactive Android app with 98 verified store locations, area filters, and direct navigation to OsmAnd or Google Maps.
✨ Features
Interactive Map
Leaflet-powered map with 98 7-Eleven locations marked and searchable by area.
Area Filters
Browse stores by Bophut, Lamai, Maenam, Nathon, and more with quick counts.
Smart Search
Find stores by name or area. Instant filtering as you type.
Direct Navigation
Open OsmAnd or Google Maps directly to any store for turn-by-turn directions.
Offline Ready
Works offline. Map tiles cached on first load for fast access without internet.
Lightweight
Only ~14 MB. Minimal resource usage for smooth performance on any Android device.
🚀 Installation
Option 1: Direct APK (Recommended)
Download from GitHub Releases:
- Enable "Install from unknown sources" in device settings (if needed)
- Download and tap the
.apkfile - Follow the installation prompts
Option 2: F-Droid
Coming soon! App will be available on F-Droid for open-source Android apps.
🛠️ Build from Source
Prerequisites
- Android SDK (API 34+) — Install
- Java 21+
- Node.js 18+
Quick Start
# Clone the repository
git clone https://github.com/alx/711-samui-map.git
cd 711-samui-map
# Set Android SDK path
export ANDROID_HOME=$HOME/Android/Sdk
# Build
./build.sh release
# Output: android/app/build/outputs/apk/release/app-release.apk
For detailed build instructions, see BUILD_INSTRUCTIONS.md
📊 Store Data
Current Coverage
Total Stores: 98 verified locations
| Area | Stores |
|---|---|
| Bophut | 48 |
| Lamai | 19 |
| Maenam | 12 |
| Nathon | 7 |
| South Samui | 4 |
| Lipa Noi | 4 |
| Taling Ngam | 3 |
| Other | 1 |
Updating Store Data
- Edit
www/locations.geojsonwith new locations - Rebuild the APK:
./build.sh release - Test on device, then release via hands.build
🔐 Security & Licensing
Permissions
The app requests minimal permissions:
- INTERNET — Fetch map tiles and routing (optional, works offline without)
- ACCESS_FINE_LOCATION — User geolocation on map (optional, disabled by default)
Privacy
- ✅ No personal data collected
- ✅ No analytics or tracking
- ✅ No ads or third-party SDKs
- ✅ All code is open-source and auditable
License
MIT License — See LICENSE for details.
You are free to use, modify, and distribute this software for any purpose, including commercial use.
📱 App Details
| Name | 711 Samui Map |
| Package ID | com.girardavila.samui711map |
| Version | 1.0.1 |
| Min Android | API 24 (Android 7.0) |
| Target Android | API 34 (Android 14) |
| Size | ~14 MB |
| License | MIT |
| Source | GitHub |
🤝 Contributing
Found a bug or want to improve the app? Contributions welcome!
- Fork the repository
- Create a feature branch:
git checkout -b feature/your-feature - Commit your changes:
git commit -m "Add feature X" - Push to branch:
git push origin feature/your-feature - Open a Pull Request
Areas for Contribution
- New 7-Eleven locations (update
www/locations.geojson) - UI/UX improvements
- Additional languages/translations
- Performance optimizations
- Bug fixes