Skip to content
Sunset Beach, NC
Get Support

Widgets and the launch Live Activity

Sunset Beach, NC ships three widgets. Sunset Beach (“The verdict, the next tide and the next good window.”) comes in four sizes: home-screen small and medium, and lock-screen rectangular and inline. Tide is a small home-screen widget with the tide curve. This week is a medium or large home-screen widget with the best thing to do each day. Every Sunset Beach size shows the overall beach score (the inline one gives it up while an NWS alert is in force). The larger sizes add the verdict, the rip risk and water temperature, the best time of day, the next tide, an active weather alert, and the next almanac window. All three widgets fetch the same small summary from the backend about every 30 minutes, and show No data with a reason if they cannot. Separately, a Live Activity counts down a visible rocket launch on the Lock Screen and in the Dynamic Island for the hour before liftoff.

SizeShowsTapping it opens
Small (home screen)“Sunset Beach” with the score in the corner · the verdict headline · the rip risk and water temperature (“Rip low · 79°”) · the best time (“Best 1:30–5 PM”, or “Best tomorrow 9 AM–1 PM” once today’s daylight is spent). An active NWS alert replaces the last two lines. With no best time, the next tide stands inToday’s best time for the best-time line; Water for the tide; Today while an alert is shown
Medium (home screen)Left: score · headline · surf height. Right: the next two tides, the next almanac window (title, rating if scored, and how far away), and any alert or warningTide rows → Water; next window → When to go; anywhere else → Today
Rectangular (lock screen)“Sunset Beach 88” · the rip risk, water temperature and next tide (“Rip low · 79° · Low 2:40 PM”; “Water 76° · …” when there is no rip forecast) · third line: an NWS alert if in force, otherwise tonight’s sunset and its sky rating (“Sunset 6:57 PM · average”) while it’s still ahead, otherwise the next window (“Shelling in 2h 10m”)Today
Inline (lock screen, beside the clock)An NWS alert if in force; otherwise “88 · Low 1:48 PM”; otherwise “Beach 88”Today

Times are in the beach’s own time zone (Eastern). The sunset’s sky rating is one of spectacular, promising, average or flat.

Alerts outrank warnings. A National Weather Service alert (“Coastal Flood Warning”) is a public hazard notice; a warning (“High rip current risk — NWS advises staying out of the water.”) is the app’s own scoring advice. When both exist the alert wins, shown with a stop-sign octagon; when several alerts are in force the first is shown with a count, “Hurricane Force Wind Warning +2”. The app’s warnings are all about the rip current, so on the small widget a warning colors the rip line and adds a warning triangle (“Rip moderate · 84°”, or “No rip forecast · 76°” out of season) rather than replacing the best time. On the medium widget a warning is shown in full. On the two lock-screen sizes only NWS alerts are shown, never warnings, and on the inline widget an alert displaces the tide entirely. National Weather Service drills and test messages are filtered out before they reach the widget, so they are never shown.

A clock icon beside the score means at least one of the sources behind the summary is a last known good copy or couldn’t be reached. Those sources are the buoys, the NWS forecast grid and alerts, the surf zone forecast, tides, sky and air quality. See How fresh the data is.

An unscored window shows no rating. If the next almanac window’s rating is not meaningful for that occurrence, the widget prints its title and time without a rating word rather than inventing one.

Tide (small, home screen) draws the next 12 hours of the tide curve at the pier, with a dot for where the water is now. Underneath it gives the next high or low with its height (“Low 2:40 PM · 0.3 ft”) and the turn after that (“high 8:58 PM”). The top corner says whether the tide is rising or falling. Tapping it opens the tide chart on Water.

This week (“The best thing to do each day this week, and which day is best for it.”) comes in two home-screen sizes:

SizeShows
MediumFive days, starting today: the day, a weather icon, the score of that day’s best pick, and a short name for it (Shells, Swim, Surf, Dolphins, Sunset)
LargeSeven days, one row each: the day, a weather icon, the high and low temperature, the pick’s full name and its score. A day where nothing scores well says so

A ★ beside a score marks the best day this week for that kind of thing. The picks are the same ones the Plan tab’s Seven days shows, and tapping the widget opens it.

  • All three widgets read the same summary. The widget fetches its own summary from the backend — a payload of a few KB built for it — with a 20-second timeout. It does not load the full conditions payload the app uses.
  • After a successful fetch it asks iOS to refresh again in 30 minutes; the Worker refreshes its sources every 5 minutes and nothing behind the summary is cached for less than 2 minutes, so refreshing faster would only re-read the same bytes. iOS treats the interval as a hint and may space refreshes further apart.
  • It also comes back about a minute after the next thing on its face passes — a tide turn, the end of the best time, or sunset — so a passed low tide isn’t shown as the next one for half an hour. These refreshes are at least 5 minutes after the last fetch, so a run of close events can’t use up the day’s refreshes.
  • After a failed fetch it retries in 10 minutes.
  • The widget shows a single point in time, not a series of future entries — everything on it depends on a forecast or observation, so nothing is extrapolated between refreshes.
  • The widget does not need the app to be open, and it always talks to the deployed Worker; opening the app also asks iOS to refresh it (at most once every 15 minutes).
What you seeMeaning
No data with a wifi-exclamation icon (small and medium) — the medium size adds the reason underneath, e.g. “HTTP 503” or “The request timed out.”The widget’s last fetch of its summary failed. It retries in 10 minutes. Check that the phone is online; if the app itself loads, the widget will recover on its next refresh.
”Sunset Beach —” (rectangular) or “Beach —” (inline)The same failure on a lock-screen size, which has no room for a reason.
A score of 88, “Go. Best for surfing.”, “Rip moderate · 84°” and “Best 1:30–5 PM”, or a High tide at 3:29 AMThis is the fixed sample shown in the widget gallery and while iOS renders a placeholder; it is not live data.
”The week isn’t available yet.” (This week)The summary arrived but had no week in it. It fills in on a later refresh.

When a rocket launch that the visibility model expects to be visible from the beach is within one hour before its scheduled liftoff (and up to 15 minutes after), the app starts a Live Activity. On the Lock Screen it shows the rocket and mission (“Falcon 9 · Bandwagon 5”) beside a countdown, then where to look in one line, “Look SE, about 25° up”. Under that, a bar fills from an hour before liftoff to the moment the plume is best seen, with “Best look about 6 min after liftoff”. If the best moment isn’t known, the bar runs to liftoff.

When the launch is not going normally, the headline says so instead and the bar is hidden:

  1. “Scrubbed — no launch tonight.” if the launch has been scrubbed;
  2. “Holding. <look direction>” if the launch is on hold;
  3. the full look direction if there is no short one, e.g. “Good chance. Look SE, about 18° above the horizon, around T+360s. You’ll need a clear ocean horizon.”;
  4. otherwise “Visible from the beach.” or “Not expected to rise above the horizon here.”

In the Dynamic Island it shows a paper-plane glyph with the countdown, and the expanded view adds the rocket and, in two lines, the status or the full look direction.

The countdown ticks on the phone itself, so it stays right with no signal. What the phone cannot know — the launch time slipping, a hold, a scrub, a launch going up, or a change in where to look and when the best look comes — is pushed to the activity by the Worker, which checks every five minutes and sends only when something has actually changed. The activity ends and clears immediately when the launch flies, fails or is scrubbed, and iOS marks it out of date 15 minutes after the scheduled liftoff if nothing further arrives.

Two things to know:

  • The app has to be open to start it. The activity is started when the app loads conditions (on launch and on every refresh) and finds a qualifying launch inside the window; the app targets iOS 17.0, which does not support starting an activity by push. Once started, updates arrive whether or not the app is open.
  • Live Activities must be allowed for Sunset Beach in iOS Settings; if they are turned off the app silently does nothing.

The Live Activity is separate from the Visible rocket launches alert on the Alerts screen, which is a one-off local notification at your chosen lead time — see Alerts and notifications.