Skip to content

docs: document widget refresh budget constraints - #363

Merged
maugauwi-hash merged 1 commit into
ethos-protocol:mainfrom
rudeus112266:docs/303-widget-refresh-budget
Aug 31, 2026
Merged

docs: document widget refresh budget constraints#363
maugauwi-hash merged 1 commit into
ethos-protocol:mainfrom
rudeus112266:docs/303-widget-refresh-budget

Conversation

@rudeus112266

Copy link
Copy Markdown
Contributor

Summary

Adds docs/widget-refresh-budget.md documenting the OS-level refresh budget constraints WidgetKit (iOS) and Glance (Android) impose on widgets, independent of what the app requests.

Context

TTLWidget.swift's computeNextUpdateInterval already scales the requested refresh interval by vault urgency (15 min normal → 2 min critical), but that behavior wasn't documented against the actual platform ceiling. This doc gives whoever picks up #198/#244/#248 the real-world numbers up front:

  • WidgetKit's observed daily reload budget and how it's silently coalesced when exceeded
  • How TTLWidget's urgency scaling spends that budget on the windows that matter rather than assuming unlimited refreshes
  • Glance's ~30-minute periodic-update floor for future Android widget work

Testing

Documentation-only change; no code paths affected. Verified references against the current TTLWidget.swift implementation.

Closes #303

@drips-wave

drips-wave Bot commented Aug 31, 2026

Copy link
Copy Markdown

@rudeus112266 Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

@maugauwi-hash
maugauwi-hash merged commit 87a2417 into ethos-protocol:main Aug 31, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document Widget Data-Refresh Budget Constraints

2 participants