"A handwritten postcard to bridge hearts—whether we are friends, acquaintances, or yet to meet."
WanderStamp is a warm Flutter Web application designed to connect travelers with people across the globe. The goal is simple: send postcard to anyone who needs a little bit of warmth, encouragement, or a travel story from afar. Spreading kindness and stories, one stamp at a time. 🌍✨
In a world of instant messaging, the physical touch of a handwritten postcard is becoming rare:
- Meaningful Connections: Sometimes a handwritten note speaks louder than a text, helping us stay connected or spark kindness with a stranger.
- Anonymity is Comfort: Sometimes it's easier to share deep thoughts or encouragement with a stranger than with someone familiar.
- Spreading Warmth: A simple "You're doing great" from a different city can change someone's day.
- ✉️ Request a Postcard: Anyone can pick a customized topic (Inspiration, Comfort, Heartbreak Healing, etc.) and submit their mailing address safely.
- 🎈 Surprise Success UI: A smooth, animated feedback dialog providing a unique 4-digit Warmth ID (W-XXXX) for tracking.
- 📍 Public Tracker: A real-time dashboard showing the journey of each postcard (pending ➔ sent ➔ received).
- 📊 Topic Insights: A live chart showing which message topics are currently most requested by the community.
- 🔒 Secure Admin Dashboard: A hidden entrance (activated by a secret gesture) for the traveler to manage requests and use GPS-stamping to mark postcards as sent.
- ❤️ Warmth Receipt: Recipients can manually enter their W-XXXX ID on the site to mark the postcard as "Received" with a simple, heart-warming UI.
- Frontend: Flutter Web (Material 3)
- Backend: Firebase Firestore (Real-time Database)
- Authentication: Firebase Auth (Admin-only)
- State Management: Provider
- Deployment: GitHub Actions & GitHub Pages
- Address Protection: Shipping addresses are strictly hidden from the public. Only the authenticated admin can access them.
- Firestore Rules: Database access is enforced via server-side security rules.
- Minimal Data: Only a nickname and address are required to participate.
- Request: Visit the Live Demo and fill out the form.
- Confirm: Once received, visit the Arrival Page and enter your ID to share the joy!
WanderStamp is a Progressive Web App (PWA). You can install it on your phone without downloading from the App Store or Google Play.
- Open the Live Demo in Chrome.
- Tap the three dots (⋮) in the top-right corner.
- Select "Install app" or "Add to Home screen".
- The WanderStamp icon will appear on your home screen!
- Open the Live Demo in Safari.
- Tap the Share button (square with an up arrow) at the bottom.
- Scroll down and tap "Add to Home Screen".
- Tap Add in the top-right corner.
- Haptic Feedback: Enjoy tactile vibrations when submitting requests or confirming arrivals.
- Standalone Mode: Once installed, the browser address bar is hidden for a true app-like experience.
- Offline Ready: Core features remain accessible even with a spotty travel connection.