Stir My Coffee™ is actively developed. Updates roll out regularly to improve speed, accuracy, and usability.
v3.0.4 – May 2026
📈 Analytics, SEO & Visibility Upgrade
Added
- Added Microsoft Clarity tracking across all site pages
- Connected Google Analytics and Clarity integrations
- Added Bing Webmaster Tools integration
- Added IndexNow support for faster search engine notifications
Improved
- Improved search visibility and indexing workflow
- Improved metadata consistency across pages
- Improved crawler discovery and sitemap handling
- Improved analytics visibility for user behavior tracking
Fixed
- Fixed duplicate title tag issue affecting SEO analysis
- Fixed duplicate metadata causing crawler confusion
- Fixed missing metadata across secondary pages
- Fixed stale route and indexing references
Technical
- Refreshed sitemap generation and indexing structure
- Added search engine verification improvements
- Added crawler and bot monitoring support
Misc
- Added emotional support for favicon-related incidents ☕🫂
v3.0.3 – May 2026
☕ Slider & UI Polish Update
Fixed
- Fixed speed slider edge cases preventing some ratings from registering correctly
- Fixed slider interaction inconsistencies affecting user input
- Fixed card width issue causing unused space in certain desktop layouts
- Fixed inconsistent card sizing between views
Improved
- Improved speed slider interaction reliability
- Improved visual consistency across location cards
- Improved responsive layout behavior
Changed
- Updated speed slider default behavior and interaction flow
- Added clearer locked-state styling for previously rated locations
Misc
- The Very Hungry Caterpillar was successfully contained 🐛☕
v3.0.2 – May 2026
☕ Address Resolution & Stability Hotfix
Fixed
- Fixed Top Picks address loading issue affecting certain Fastest locations
- Fixed duplicate geocoding requests causing some addresses to remain stuck on "Locating address..."
- Resolved address loading edge cases caused by duplicate location processing
- Fixed speed rating edge cases preventing some slider values from registering correctly
- Fixed layout width issue causing cards to leave unused space in certain views
- Fixed inconsistent card sizing between Rate Shops and Best Nearby layouts
Improved
- Added strict location deduplication before reverse-geocoding requests
- Improved request sequencing for address lookups
- Improved reliability of address resolution across Top Picks and Best Nearby views
- Reduced unnecessary API calls during UI refreshes
- Improved responsive layout behavior between list and sidebar views
- Improved visual consistency across location cards
- Improved speed rating interaction reliability
Changed
- Updated speed slider interaction flow with improved default behavior
- Updated speed slider styling with new blue visual system
- Added clearer locked-state styling for previously rated locations
Technical
- Added protected ID-based batching logic for geocoding operations
- Introduced request throttling to reduce reverse-geocoder rate-limit issues
- Improved render/update flow for asynchronous address loading
Misc
- The Very Hungry Caterpillar was successfully contained 🐛☕
v3.0.1 – May 2026
☕ Post Launch Stabilization Update
Fixed
- Fixed speed slider issue preventing certain ratings from registering correctly
- Fixed slider interaction edge cases causing inconsistent vote behavior
- Fixed missing brand font loading across secondary pages
- Corrected minor UI inconsistencies and typography issues
Improved
- Reworked speed rating interaction to start from a neutral state
- Added clearer visual feedback for speed rating controls
- Improved disabled-state behavior for previously rated locations
- Enhanced visual consistency across supporting pages
Changed
- Updated speed slider styling with new blue visual system
- Improved slider state clarity between active and locked ratings
- Refined interaction flow to reduce accidental input
Misc
- The coffee inspectors found a few loose beans ☕🔧
v3.0.0 – May 2026
☕ Stir My Coffee 3.0 – The Platform Release
Added
- New Accuracy and Speed status bars for faster visual comparison between shops
- Swipe navigation between core mobile views (Rate Shops, Best Nearby, Interactive Map)
- “How Ratings Work” contextual help system replacing cluttered inline legends
- Expanded coffee chain detection system with broader alias recognition
- Official 7 Brew branding and icon support
- Google Play “Rate Us” integration for app feedback and growth
Improved
- Major mobile UI refinement with cleaner spacing, hierarchy, and card presentation
- Refined coffee-inspired color palette with warmer tones and stronger visual identity
- Improved footer layout and visibility for important actions and engagement
- Enhanced onboarding messaging and clarity for first-time users
- Improved scanability and readability of location cards
- More app-like interaction flow across Android and web
- Refined “Best Nearby” experience for faster coffee decisions on the go
Changed
- Reworked location cards with lightweight visual metric indicators
- Simplified ratings explanation system to reduce UI clutter
- Updated branding direction to focus on order accuracy and service speed
- Improved responsiveness and consistency across mobile layouts
- Adjusted voting cooldown logic for smoother real-world usage patterns
UX
- Reduced cognitive load for first-time users
- Faster comparison between coffee shops while mobile
- Improved one-handed navigation and interaction flow
- Cleaner and more intentional visual hierarchy throughout the app
- More cohesive experience across map, list, and nearby views
Technical
- Improved mobile gesture handling for swipe navigation
- Refactored reusable card rendering system for visual metric components
- Expanded chain normalization logic for better dataset consistency
- Additional responsive layout cleanup and performance optimization
- General UI cleanup and production polish across the platform
Misc
- This is the update where Stir My Coffee stops feeling like a beta… and starts feeling real ☕🔥
v2.7.1 – Apr 2026
🔍 SEO Optimization Update
Improved
- Enhanced homepage title tag for stronger search intent targeting
- Upgraded meta description to improve click-through rate from search results
- Expanded Open Graph and Twitter tags for better social sharing previews
- Improved canonical, robots, and metadata consistency
- Added richer structured data for search engine understanding
Growth
- Strengthened discoverability for coffee-related local searches
- Improved foundation for long-tail traffic and brand visibility
Misc
- Quiet update. Loud results. ☕📈
v2.7.0 – Apr 2026
🚀 Android Beta Launch & Support System
Added
- Google Play closed beta launch for Android testers
- Native install experience for Android users
- Dedicated Support / Donate page to help fund hosting and future development
- Direct support pathway for community members who want to back the project
Improved
- Faster repeat access through installed app experience
- Easier onboarding for mobile users outside the browser
- Stronger platform legitimacy through official Google Play presence
Platform
- Stir My Coffee now available as both web platform and Android beta app
- Expanded reach beyond browser-only users
Community
- Began closed beta tester recruitment for launch approval process
- Early user feedback loop established for app refinement
Misc
- This is the update where Stir My Coffee steps onto the Play Store ☕📱🔥
v2.6.1 – Apr 2026
☕ Dataset Expansion & Ingestion Pipeline
Added
- Added multiple coffee chain datasets via Overpass API (Peet’s, Dutch Bros, Caribou, etc.)
- Added Krispy Kreme locations to expand coffee-adjacent coverage
- Implemented repeatable Overpass → Firebase ingestion workflow
Improved
- Increased map density across multiple regions for better user experience
- Reduced empty-map scenarios in lower-density areas
- Improved perceived completeness for new users
Data
- Seeded new locations with baseline vote data (accuracy + speed)
- Maintained consistent ID structure across all new locations
- Prevented duplicate inserts during ingestion
Developer
- Established scalable ingestion pipeline for future expansion
- Improved data normalization and processing reliability
Misc
- This is the update where the map starts feeling alive everywhere ☕🌎🔥
v2.6.0 – Apr 2026
✨ Header UX & SEO Interaction Upgrade
Added
- Interactive “What is Stir My Coffee?” side panel for contextual information
- Clean single-panel layout for SEO content (no duplicate or stacked blocks)
Improved
- Refined header typography and spacing for tighter visual hierarchy
- Aligned tagline and supporting text for cleaner brand presentation
- Improved readability and structure of introductory content
Fixed
- Resolved duplicate SEO content rendering as multiple panels
- Fixed layout bug causing text to appear under header and in floating panel simultaneously
- Fixed theme override issue affecting brand accent color
UX
- Reduced visual clutter in header
- Introduced on-demand information instead of always-visible text
- Improved first impression and scanability for new users
Misc
- This is the update where the header finally feels intentional ☕✨
v2.5.1 – Apr 2026
🧠 Ranking System Overhaul
Improved
- Rebuilt About page creator section with cleaner layout, tighter spacing, and stronger personal narrative
- Rebuilt core ranking algorithm to better reflect real-world shop performance
- Balanced scoring system combining order accuracy and speed
- Added vote-based confidence scaling to prevent low-sample bias
- Eliminated misleading rankings from low-vote or unbalanced data
Changed
- “Best Overall” now uses a hybrid scoring system (accuracy + speed + confidence)
- “Fastest” now ranks purely by speed
- “Best Quality” now ranks purely by accuracy
- Reordered Top Picks to show “Best Overall” first
UX
- Improved readability and flow of creator story (less spacing, more impact)
- More intuitive and trustworthy rankings
- Clear alignment between labels and behavior
- Faster decision-making for users
Technical
- New scoring system using normalized metrics and confidence weighting
- Simplified category logic for better maintainability
Misc
- Version number now updates automatically across the entire site
- This is the update where the app starts thinking like a user ☕🧠🔥
v2.5.0 – Apr 2026
🚀 Programmatic SEO System
Added
- Generated 18,000+ location-specific pages for improved search visibility
- Introduced static SEO page generation pipeline using template-based rendering
- Created scalable location URL structure (
/locations/[slug].html)
- Implemented automated sitemap generation with support for large datasets
Changed
- Shifted from client-rendered location pages to static pre-rendered SEO pages
- Improved search engine crawlability and indexing potential
SEO
- Massive increase in searchable surface area across U.S. coffee locations
- Each location now has a dedicated, indexable page with structured metadata
- Improved discoverability for long-tail search queries
Technical
- Built Node.js page generation system from location dataset
- Implemented sitemap index with segmented location sitemaps
- Ensured unique slug generation using deterministic location data
Misc
- This is the update where Stir My Coffee becomes discoverable ☕🚀
v2.4.0 – Apr 2026
🔥 Real-Time Data System (Firebase Only)
Added
- Full Firebase-powered location system (removed dependency on static JSON)
- Unified location + vote data pipeline using consistent ID structure
- Live vote + location synchronization across all views
Changed
- Removed
coffeeLocations.json from runtime (now fully database-driven)
- Refactored data loading to pull locations and votes directly from Firestore
- Standardized ID matching across locations and votes collections
Fixed
- Resolved missing location data in Coffeenomics and map views
- Fixed ID mismatch issues between legacy vote data and location records
- Fixed edge cases where user-added locations failed to resolve
Performance
- Eliminated large JSON fetch (~19k locations) improving initial load
- Reduced memory footprint by removing static dataset from client
- Improved scalability for future growth and real-time updates
Developer
- Completed migration of legacy vote data to deterministic ID system
- Established clean, scalable Firestore structure for long-term growth
Misc
- This is the update where Stir My Coffee goes fully live data ☕🔥
v2.3.0 – Apr 2026
🚀 Performance & Core UX Breakthrough
Added
- LocalStorage caching system with expiration for location data
- Progressive data loading pipeline (instant UI → background updates)
- Branded loading screen with rotating coffee puns
Improved
- Massive perceived performance improvement via non-blocking initialization
- Instant UI rendering using cached or static data
- Reduced Firebase load with limited queries
- Improved mobile tap accuracy for map markers
Changed
- Removed blocking load patterns in app initialization
- Shifted to parallel async loading architecture
- Simplified loading screen to a single branded spinner
UX
- Eliminated long “dead load” experience
- Introduced progressive rendering for smoother data loading
- Improved mobile interaction reliability
- Loading experience now reinforces brand personality
Performance
- Reduced blocking operations across app startup
- Optimized Firestore reads with query limiting
- Cached location data for instant repeat visits
Misc
- This is the update where the app stops feeling slow… and starts feeling fast ☕⚡🔥
v2.2.0 – Apr 2026
✨ Mobile UX & Header System Refinement
Improved
- Redesigned mobile header with anchored, app-style layout for better usability
- Improved interaction clarity by separating context (logo + instructions) from actions (buttons)
- Enhanced button layout with equal-width responsive controls
- Refined spacing, alignment, and visual hierarchy across mobile view
Changed
- Transitioned mobile header from floating glass UI to fixed top navigation bar
- Reworked header structure to eliminate floating layout issues
- Updated instruction placement for improved readability and reduced wrapping
- Adjusted responsive behavior to better differentiate desktop vs mobile experience
UX
- Reduced visual clutter and improved scan flow on mobile
- Improved perceived stability and usability with anchored navigation pattern
- Created more native app-like experience on mobile devices
Misc
- This is the update where the mobile experience finally clicks 📱☕🔥
v2.1.0 – Apr 2026
✨ UI & Map Experience Upgrade
Improved
- Redesigned map header with lightweight, centered glass-style layout
- Simplified interaction guidance for faster onboarding
- Improved navigation clarity with updated button labels (List View, Locate Me)
- Unified button styling with consistent brand-aligned appearance
- Enhanced visual hierarchy to prioritize map interaction
Added
- Dynamic header system that updates based on user actions (add, vote, interact)
- Custom cluster styling with improved visibility and interaction feedback
- Subtle animation and hover feedback across map controls
Changed
- Refactored map UI layout to reduce visual clutter and improve focus
- Updated cluster rendering system to support custom styling
- Improved consistency between map interactions and overall app behavior
v2.0.0 – Apr 2026
🚀 Major Release – Data System Overhaul
Added
- Unified location identity system using deterministic ID generation (name + lat/lng)
- Seamless merging of static dataset (19k+ locations) with real-time Firebase data
- Real-time vote synchronization across Map and List views
- Scalable voting architecture supporting large datasets without performance degradation
- Consistent 5-star speed rating system across all components
Changed
- Refactored data loading pipeline to support hybrid static + dynamic sources
- Standardized vote schema (
upvotes, downvotes, speedTotal, speedVotes)
- Rebuilt map rendering pipeline for consistency with index view
- Aligned UI behavior between map and list views (votes + ratings)
Fixed
- Resolved vote desync between map and index views
- Fixed ID mismatches causing missing or incorrect vote data
- Fixed speed rating inconsistencies (
speedCount → speedVotes)
- Fixed map popup hover interaction issues
Performance
- Optimized handling of large datasets (19k+ locations)
- Reduced redundant computations during render cycles
- Improved real-time update efficiency via Firestore listeners
Developer Experience
- Cleaner separation between static data, Firebase data, and UI logic
- Improved maintainability of location and vote systems
- Established foundation for future features (moderation, ranking, analytics)
Misc
- This is the update where Stir My Coffee stops being a project… and becomes a platform ☕🔥