actualbudget/actual

[Bug]: Fatal error when opening off wifi

Open

#7886 opened on May 18, 2026

View on GitHub
 (1 comment) (0 reactions) (0 assignees)JavaScript (7,129 stars) (603 forks)batch import
bughelp wantedregression

Description

What happened?

I was trying to open Actual while disconnected from my wifi and the app fataled.

Context: an iPhone 16 Plus running iOS 26.4, with the app pinned to the homescreen as a webapp.

I was able to resolve the issue by deleting the app from the home screen and recreating it.

I've attached the screenshot I captured that has part of the stack.

Thanks!

How can we reproduce the issue?

As mentioned above, I was simply trying to launch the app while off wifi, and that deleting and recreating the webapp on the home screen resolved the issue.

Where are you hosting Actual?

Docker

What browsers are you seeing the problem on?

Safari

Operating System

Mobile Device

Contributor guide

Tech stack
javascriptreactnodejs
Domain
frontend
Issue type
bug
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
fresh
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
mostly clear
Prerequisites
Knowledge of PWA offline behaviorUnderstanding of iOS Safari web app limitationsFamiliarity with service workers
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
50
Research direction
Investigate the service worker registration and caching strategy in the PWA. Check for errors when the app is loaded without network connectivity, particularly on iOS Safari. Look at the service worker file (e.g., 'public/service worker.js') and the app initialization code to see if there is a missing offline fallback. Consider testing on an iOS device or simulator.