💡 Expo Home Screen Widget for Live Market Status

[github-actions[bot]]

Summary

Use Expo's new Widgets API (alpha in SDK 55) to display live market-day status directly on the customer's home screen — vendor count checked in, next market time, and followed vendor alerts — without opening the app. This creates a passive, always-visible engagement surface that reinforces the confidence-first positioning and differentiates Markets from every competitor in the space.

Market Signal

Expo SDK 55 (Feb 2026) introduced Expo Widgets (alpha) supporting iOS home screen widgets and Live Activities. No competing farmers market app offers home screen widgets — LocalHarvest is web-only, Farmish has no mobile-native innovation, and market management tools (ManageMyMarket, Marketspread) don't have consumer-facing mobile apps. Apple's continued emphasis on widgets and Live Activities as primary engagement surfaces means customers increasingly expect glanceable information without app launches. Source: Expo SDK 55 Changelog.

User Signal

Rachel (customer persona) plans her Saturday morning around market confidence. Currently she must open the app to check vendor status. A home screen widget showing "12 of 18 vendors checked in at Riverside Market" or "Green Valley Farm just checked in" delivers the confidence signal passively. The PRD's 60-second propagation SLO (NFR2) ensures widget data stays fresh. This aligns with the PRD's core metric: customer confidence that translates into trips taken and completed.

Technical Opportunity

Expo Widgets is built on the Expo Modules API and supports both static and timeline-based widgets. The existing Firebase Realtime Database architecture (paths: /markets/{marketId}/vendors/{vendorId}/status) provides the real-time data source. Widget updates can be triggered by background push notifications via FCM, which is already in the planned stack (Epic 7). The widget would read from MMKV (already planned for offline cache), keeping the widget process lightweight. iOS Live Activities could show real-time check-in progress during market hours — a natural extension of the widget concept.

Assessment

Dimension	Score	Rationale
Feasibility	med	Expo Widgets is alpha; needs to mature through 1-2 SDK releases before production use
Impact	high	Unique differentiator — no competitor offers this; directly serves confidence-first positioning
Urgency	med	Post-MVP feature; timing aligns with Epic 6 (Customer Discovery) development

Adversarial Review

Strongest objection: Expo Widgets is in alpha — shipping production features on alpha APIs risks breaking changes, platform instability, and App Store rejection. The Markets app has no codebase yet; adding experimental features before core functionality exists is premature optimization.

Rebuttal: The proposal is timed for post-MVP development, not Sprint 1. By the time Markets reaches the customer discovery epic (Epic 6), Expo Widgets will have matured through several SDK releases. The widget is a read-only view of existing data — it adds no new backend complexity and is architecturally decoupled. Even if the API changes, the widget is a thin UI layer that can be updated without touching core logic. Starting the design work now (data model, update triggers) ensures the architecture supports widgets from day one.

Suggested Next Step

Track Expo Widgets API stability through SDK 56-57 releases; create a proof-of-concept widget showing static market data once Epic 6 customer discovery is underway. Design the MMKV data contract that both the main app and widget process will share.

[github-actions[bot]]

Weekly Update

What Changed

Expo SDK 56 (May 2026) promoted expo-widgets to STABLE — this is a major feasibility upgrade since this idea was proposed. Key improvements:

• Zero native setup: Home screen widgets and Live Activities can now be built as React components using Expo UI — no SwiftUI required, no separate Xcode target, no manual App Groups
• Full environment access: No pre-rendering required; better timeline management, error handling, and config plugin support
• Live Activities support: Beyond home screen widgets, Live Activities now work on the iOS lock screen and Dynamic Island — ideal for real-time market-day status (vendor check-in count climbing, "your vendor just checked in" alerts, market countdown timer)
• Cross-platform widgets: Home screen widgets work on BOTH iOS and Android; Live Activities are iOS-specific progressive enhancement
• Hermes V1 default: SDK 56 ships Hermes V1 by default — faster startup and lower memory usage benefit widget rendering

Additionally, Google Wallet's "Nearby Passes" geofence notifications have been stable since October 2025, enabling complementary location-triggered engagement on Android (surface a market loyalty pass on the lock screen when near a market).

New competitor context: No farmers market app (Localize, Farmish, Seen Markets, MarketWurks) uses widgets or Live Activities. First-mover window is open.

Updated Assessment

Dimension	Previous	Current	Delta
Feasibility	med	high	↑ expo-widgets stable, no SwiftUI needed
Impact	high	high	→ Unchanged — glanceable truth remains a core UX principle
Urgency	med	med	→ First-mover window open but no competitive pressure yet

Recommendation

Advance — The technology risk that was the main concern is now eliminated. Recommend designing three widget surfaces as part of the next planning cycle:

1. "Next Market" small widget: nearest upcoming market with vendor count and time
2. "Following" medium widget: status of followed vendors (checked in / not yet / absent)
3. Market Day Live Activity: real-time check-in counter + countdown timer on lock screen during active market hours

Implementation path: upgrade to Expo SDK 56, add expo-widgets dependency, connect widget data to Firebase Realtime Database subscription paths.

[github-actions[bot]]

Weekly Update

What Changed

Expo SDK 56 stabilized iOS widgets and Live Activities (September 2026). This is a significant technical enabler:

• expo-widgets is now stable (not experimental) as of SDK 56. Widgets and Live Activities can be built as React components using Expo UI — no SwiftUI required.
• Configurable widgets are now supported — users can choose what a widget displays from the iOS widget gallery (e.g., select which market or vendor to track) without opening the app first.
• Continuous Native Generation handles Widget Extension targets, App Group configuration, and SwiftUI scaffolding automatically.
• Widgets receive their environment directly and no longer need to be pre-rendered by the main app.
• SDK 56 also upgrades to React Native 0.85.2 and React 19.2.3.

Competitive context: FarmStand and Farmish both added real-time inventory features in 2026, but neither offers home screen widgets. This remains a differentiation opportunity.

Updated Assessment

Dimension	Previous	Current	Delta
Feasibility	med	high	↑ SDK 56 stabilization removes experimental risk; configurable widgets are a first-class feature
Impact	high	high	→ Core value proposition unchanged — glanceable market-day status
Urgency	med	high	↑ SDK 56 is current; the technical path is now clear and documented

Recommendation

Advance. With SDK 56's stable widget support, this feature moves from "promising but risky" to "clearly buildable." The configurable widget capability is especially valuable — a customer could configure their home screen widget to show their favorite market's vendor lineup, or a vendor could see their follower count and check-in reminder. Recommend adding this to the Growth Features backlog with a concrete technical spike story.