Skip to content
Sunset Beach, NC
Get Support

Get the app and find your way around

Sunset Beach, NC comes in two forms: a native iPhone app (iOS 17 or later, iPhone only — it appears on your home screen as Sunset Beach) and a single web page at https://sunsetbeach.neuralconfig.com. Both read the same backend and cover the same one beach — Sunset Beach, North Carolina — but the app is the full product. It has five tabs (Today, Water, Plan, Nature, More), a search sheet, alerts, widgets and Siri phrases; the web page is one scrolling summary with none of those. Every time in either is shown in the beach’s own time zone (US Eastern), whatever time zone your phone is in.

iPhone appWeb page
WhereThe Sunset Beach, NC app; needs iOS 17 or later; iPhone only (no iPad layout)sunsetbeach.neuralconfig.com in any browser
LayoutFive tabs plus pushed screens, search, an Alerts sheet (bell on Today, Water and Plan; Alerts row on More)One page, top to bottom
RefreshPull down on any tab; a saved copy is shown while it loadsReloads itself every 5 minutes while the tab is open
Alerts, widgets, Siri, share sheetYesNo
Water quality, parking, beach rules, tropics, shellfish, cams, offshore forecast, surge, fishing, the Seven days plannerYesNo
Sources listMore › Sources”Where this comes from” table at the bottom

The web page shows, in order: the beach verdict and score, the tide curve, What it’s good for, When to go (the next almanac window and the week’s windows), What’s on, On the water right now, Sun, sky & air, Sea turtles, What else is out there, Right whales & the map, Seen near here lately, Birds, The year, Runoff & river water, After dark — rockets over the Atlantic, and Where this comes from. While it loads it says “Reading the instruments…”; if the backend cannot be reached it says “Couldn’t load conditions: …” with the browser’s error.

The rest of this page is about the app.

The tab bar has five entries. Each tab has a page in these docs.

Tab labelScreen titleWhat it holdsDocs
TodaySunset BeachThe verdict and its four tiles, alerts, the best time today, the next hours, what today is good for, sunrise or sunset, the week ahead, water quality, UV and air, parking, what’s coming upThe Today tab
WaterWaterThe tide now and the day’s highs and lows, the coming days’ tides, the surf, and Further out: the offshore forecast, the sound and the ICW, and shellfish closuresThe Water tab
PlanPlanFilter chips, Seven days (each day’s best pick), Worth a trip, the next visible launch, and events by dayThe Plan tab
NatureNatureWhat’s happening now, right whales, fishing, recent sightings, Overhead (migration radar, birds) and Through the year (times and seasons, sea turtles, marine life)The Nature tab
MoreMoreAn Alerts row, the Sources screen, Known gaps, Beach info, How it’s built, and This app (user guide, support, privacy, terms, acknowledgements and the version number)Beach info

Version 1.1 renamed two tabs and moved one screen. Events became Plan, which also took over the week planner that used to be under Nature. Info became More, and the old Info screen is now Beach info, one tap down from More beside Sources. Old links, Siri shortcuts and Shortcuts that named the old tabs still open the right screen.

The toolbar corners are consistent across tabs:

  • Magnifier (top left, every tab) opens search.
  • Share (top right, Today, Water and Plan only) opens the iOS share sheet with a text summary of that screen — see Sharing. Nature and More have nothing time-sensitive to send, so they have no share button.
  • Bell (top right, Today, Water and Plan) opens the Alerts sheet — see Alerts and notifications. Nature and More have no bell; instead the More tab carries a labelled Alerts row (with a one-line summary such as Tides · Push, All off, Not set up or Off in iOS Settings) that opens the same sheet.

The Nature tab is divided by two band headings, Overhead and Through the year. They are signposts, not sections.

On launch the app draws the last payload it saved to disk before it asks the network, so a cold launch usually shows the beach immediately with a banner that reads “Saved 5m ago. Refreshing…” (the age is the payload’s own timestamp — the same clock Today prints as Updated …). The banner disappears when the refresh lands.

If nothing is saved yet, you see a spinner on the launch colour while the first request runs.

If a request fails you see one of two things:

You seeMeaning
A banner: “Showing saved data. reason”A refresh failed but the app still has data on screen. Nothing was blanked; the numbers are as old as the Updated line on Today says.
A full screen: “Can’t load conditions” with the reason and a Try again buttonThe request failed and there was no readable saved copy to show — for example, first launch with no signal. Tap Try again, or pull down once you have a connection.

The reason is the transport error, or “The server sent an error (HTTP code).” if the backend answered with an error, or “Couldn’t read the server’s reply: …” naming the field if the payload could not be decoded. A request gives up after 30 seconds without a response and after 60 seconds overall, so a phone with no signal reaches “Can’t load conditions” in about a minute rather than spinning forever.

Every tab supports pull to refresh. There is no refresh button. Coming back to the app when its last successful load is more than five minutes old refreshes it automatically.

The backend refreshes every upstream source on a 5-minute schedule and keeps the last good copy of each. When one source is down, the backend serves that copy rather than nothing, flags it as stale, and the app labels it instead of passing it off as live. On the Sources screen (More › Sources) the row shows a Cached badge and, in the source’s detail, Showing last good reading with the reason under Showing cached data because; the Plan tab’s next visible launch card carries the same badge. A source with no good copy at all shows Unavailable. Which sources this happens to, how old a copy can get, and what the Sources screen shows are on How fresh the data is.

Most section headers carry a small ⓘ beside the title. Tapping it opens a half-height sheet with that section’s explainer: what the data is, where it comes from, and its limits — how old a water sample is, why there is no wave sensor at this beach, what a migration count can and cannot tell you. There are 26 of them, and they are worth reading; the caveats are part of the data. Twenty-four sit behind a ⓘ button; two — Right now and the events explainer — have none and are reached only through search. Every explainer is also a search result of its own (captioned Explainer), so you can find Water above the tide table or How scoring works without knowing which section it hangs off. VoiceOver reads each button as About … followed by the section title.