feat: support widget scheduling

[V3RON]

You can now schedule multiple widget states to display automatically at different times. This is perfect for weather forecasts, calendar events, or any app that needs content to change throughout the day - even when your app isn't running.

Instead of just updating a widget once, you can now batch-schedule multiple entries:

await scheduleWidget('weather', [
  { date: now, variants: { systemSmall: <MorningForecast /> } },
  { date: tomorrowMorning, variants: { systemSmall: <AfternoonForecast /> } },
  { date: tomorrowAfternoon, variants: { systemSmall: <EveningForecast /> } }
])

Additional Improvements

Automatic UserDefaults Cleanup:

• Orphaned widget data is automatically removed on app launch (when widgets are deleted from home screen)
• Expired timeline entries are automatically pruned when widgets refresh
• Keeps App Group storage lean without manual intervention

Size Validation:

• Warns if widget payloads exceed 50KB (helps prevent UserDefaults bloat)
• Warns if timelines exceed 100KB
• Non-breaking - logs warnings instead of throwing errors

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
voltra	Ready	Preview, Comment	Jan 18, 2026 8:46pm