HomeMoviesSeries
For YouCalendar
diff --git a/docs/skyline-design-guide.md b/docs/skyline-design-guide.md
index 63f391603..3cb832902 100644
--- a/docs/skyline-design-guide.md
+++ b/docs/skyline-design-guide.md
@@ -51,7 +51,7 @@ All dimensions in this guide are **mockup pixels at 1920×1080**, which map:
| Android TV (Compose) | 1 px = **0.5 dp** (1080p TV ≈ xhdpi → 960×540 dp window) | 32 dp |
Sanity check against existing code: tvOS poster `260×390 pt` ≡ Android `130×195 dp`
-(already true in `ContinuumTheme.swift` / `Spacing.kt`), so existing token files
+(already true in `PrairieTheme.swift` / `Spacing.kt`), so existing token files
already follow this rule. Android text sizes below assume the TV app's global
0.86 font-scale stays in place — give Compose the sp values listed, not px/2 of type.
@@ -61,7 +61,7 @@ already follow this rule. Android text sizes below assume the TV app's global
```
TOP BAR (persistent on all root screens)
-├─ SILO wordmark (left, non-interactive)
+├─ PRAIRIE wordmark (left, non-interactive)
├─ Tabs (center):
│ Home
│ Movies ── cascading selector on focus (§5.3)
@@ -133,7 +133,7 @@ FULL-SCREEN (pushed over everything, no top bar):
## 4. Design tokens
-Unchanged from the current apps (`ContinuumTheme.swift`, `Color.kt`): background
+Unchanged from the current apps (`PrairieTheme.swift`, `Color.kt`): background
`#000000`, surface `#0A0A0A`, elevated `#15171C`, primary text `#EDEDED`,
secondary = primary @ 60%, tertiary @ 38%, hairline white @ 12%, error `#B00020`,
rating amber `#FFC107`. Radii: 8 / 12 / 18 (+ pill = capsule). No chromatic accent.
diff --git a/docs/skyline-implementation-prompt.md b/docs/skyline-implementation-prompt.md
index 90e027bd8..64cebb2a1 100644
--- a/docs/skyline-implementation-prompt.md
+++ b/docs/skyline-implementation-prompt.md
@@ -2,7 +2,7 @@
> **Status:** Phase 1 (chrome) is **complete** on `feature/skyline-phase-1`
> (type-derived tabs · pill row · Libraries/For You roots removed · profile
-> dropdown · `ContinuumTheme.Skyline` tokens). This prompt targets **Phase 2 —
+> dropdown · `PrairieTheme.Skyline` tokens). This prompt targets **Phase 2 —
> the focus marquee** from guide Rev 2. Write the Phase 3 (cascading selector)
> and Phase 4 (polish & parity) prompts after this phase merges.
@@ -33,7 +33,7 @@ Implement **Phase 2 of the Skyline navigation redesign** for the tvOS app: the
`iosApp/iosApp/Screens/Home/HomeView.swift`,
`iosApp/iosApp/Screens/Home/FeaturedCarousel.swift`,
`iosApp/iosApp/tvOS/Components/TVRootHeroBackdrop.swift`,
- `iosApp/iosApp/Theme/ContinuumTheme.swift` (the `Skyline` namespace).
+ `iosApp/iosApp/Theme/PrairieTheme.swift` (the `Skyline` namespace).
## What Phase 1 already built (do not redo)
@@ -57,7 +57,7 @@ Implement **Phase 2 of the Skyline navigation redesign** for the tvOS app: the
1. **`TVFocusMarquee` component** (new, tvOS-only) per guide §5.4/§5.5: two
scales — Home (block top 218, title 84, eyebrow 17) and library (top 246,
title 66, eyebrow 16). Eyebrow = the **source row's title**, preceded by the
- `marquee.tick` dash (white @ 85%, 26×3, r 2 — add to `ContinuumTheme.Skyline`).
+ `marquee.tick` dash (white @ 85%, 26×3, r 2 — add to `PrairieTheme.Skyline`).
Meta line: codec/HDR badges, then year·genre·runtime, or
`S2 E7 · episode title · 23 min left` for episodic items. 2-line synopsis,
max-width 780 (clamp to 1 line if the title wraps to 2). Title falls back to
@@ -112,8 +112,8 @@ any server changes, any iOS/macOS behavior changes.
Search, Calendar, Recommendations) are also compiled for iOS/macOS — guard
tvOS-only changes and keep the other platforms building unchanged.
- Match existing style: types `PascalCase`, the `TV` prefix for tvOS views,
- tokens from `ContinuumTheme` / `Colors.swift` — no hardcoded values, add new
- tokens to the theme (`ContinuumTheme.Skyline` exists from Phase 1). No new
+ tokens from `PrairieTheme` / `Colors.swift` — no hardcoded values, add new
+ tokens to the theme (`PrairieTheme.Skyline` exists from Phase 1). No new
dependencies. No tests for this UI work unless shared logic changes (per
`CLAUDE.md`).
- Branch `feature/skyline-phase-2` stacked on `feature/skyline-phase-1` (or on
@@ -131,7 +131,7 @@ The codebase already encodes several tvOS lessons — preserve them:
once. Tab switches swap content under the stack; they are not pushes.
- **The top menu is custom on purpose** (the system `TabView` sidebar steals
leftward focus). Keep the custom bar; keep `.focusEffectDisabled()` +
- chrome driven by focus state (`ContinuumFlatButtonStyle` pattern) rather
+ chrome driven by focus state (`PrairieFlatButtonStyle` pattern) rather
than the system halo.
- **The marquee never participates in focus.** No focusable subviews, no
`focusSection` membership; the vertical zone model becomes top bar → pill
diff --git a/docs/superpowers/plans/2026-06-14-companion-pairing-card-ios.md b/docs/superpowers/plans/2026-06-14-companion-pairing-card-ios.md
index 38b3720e3..0039a2f6e 100644
--- a/docs/superpowers/plans/2026-06-14-companion-pairing-card-ios.md
+++ b/docs/superpowers/plans/2026-06-14-companion-pairing-card-ios.md
@@ -32,7 +32,7 @@
- Regenerate the project after adding/removing files: `xcodegen generate --spec iosApp/project.yml` (writes `iosApp/Prairie.xcodeproj`; no `cd` needed).
- iOS build (no signing): `xcodebuild build -project iosApp/Prairie.xcodeproj -scheme Prairie -destination 'generic/platform=iOS Simulator' CODE_SIGNING_ALLOWED=NO`
- tvOS build: same with `-scheme PrairieTV -destination 'generic/platform=tvOS Simulator'`.
-- The card deliberately uses **system blue** for its primary button and selection accents (the app's global tint is `.continuumOnSurface`, near-white). Blue matches the native iOS pairing aesthetic the card emulates. This is intentional, not a mistake.
+- The card deliberately uses **system blue** for its primary button and selection accents (the app's global tint is `.prairieOnSurface`, near-white). Blue matches the native iOS pairing aesthetic the card emulates. This is intentional, not a mistake.
---
@@ -360,10 +360,10 @@ struct CompanionPairingCard: View {
VStack(spacing: 0) {
heroGlyph.padding(.bottom, 16)
Text("Set Up \(tv.name)")
- .font(.continuumTitle)
+ .font(.prairieTitle)
.multilineTextAlignment(.center)
Text("Sign this Apple TV in using this iPhone.")
- .font(.continuumCaption)
+ .font(.prairieCaption)
.foregroundStyle(.secondary)
.multilineTextAlignment(.center)
.padding(.top, 6)
@@ -400,7 +400,7 @@ struct CompanionPairingCard: View {
.background(accent, in: RoundedRectangle(cornerRadius: 9, style: .continuous))
.foregroundStyle(.white)
Text(server.displayName)
- .font(.continuumBody)
+ .font(.prairieBody)
.foregroundStyle(.primary)
Spacer()
Image(systemName: isOn ? "checkmark.circle.fill" : "circle")
@@ -410,7 +410,7 @@ struct CompanionPairingCard: View {
.padding(.horizontal, 14)
.padding(.vertical, 12)
.background(
- isOn ? Color.continuumChromeSelectedFill : Color.continuumChromeRestingFill,
+ isOn ? Color.prairieChromeSelectedFill : Color.prairieChromeRestingFill,
in: RoundedRectangle(cornerRadius: 13, style: .continuous)
)
}
@@ -420,15 +420,15 @@ struct CompanionPairingCard: View {
private func confirm(serverName: String, matchCode: String) -> some View {
VStack(spacing: 0) {
Text("Make sure your TV shows")
- .font(.continuumCaption)
+ .font(.prairieCaption)
.foregroundStyle(.secondary)
Text(matchCode)
- .font(.continuumPIN)
+ .font(.prairiePIN)
.textCase(.uppercase)
.tracking(8)
.padding(.top, 8)
Text("for \(serverName)")
- .font(.continuumCaption)
+ .font(.prairieCaption)
.foregroundStyle(.secondary)
.padding(.top, 4)
primaryButton("Yes, this matches") { Task { await coordinator?.confirmMatch() } }
@@ -445,11 +445,11 @@ struct CompanionPairingCard: View {
.foregroundStyle(.green)
.padding(.bottom, 12)
Text(signedIn.isEmpty ? "Nothing set up" : "Set up \(signedIn.joined(separator: ", "))")
- .font(.continuumHeadline)
+ .font(.prairieHeadline)
.multilineTextAlignment(.center)
if !failed.isEmpty {
Text("Couldn’t set up: \(failed.joined(separator: ", "))")
- .font(.continuumCaption)
+ .font(.prairieCaption)
.foregroundStyle(.secondary)
.multilineTextAlignment(.center)
.padding(.top, 4)
@@ -465,7 +465,7 @@ struct CompanionPairingCard: View {
.foregroundStyle(.yellow)
.padding(.bottom, 12)
Text(message)
- .font(.continuumBody)
+ .font(.prairieBody)
.multilineTextAlignment(.center)
primaryButton("Close") { animateOut(onClose) }.padding(.top, 22)
}
@@ -484,8 +484,8 @@ struct CompanionPairingCard: View {
HStack(spacing: 12) {
Image(systemName: "appletv.fill").font(.system(size: 22)).frame(width: 40, height: 40)
VStack(alignment: .leading, spacing: 2) {
- Text(title).font(.continuumHeadline)
- Text(subtitle).font(.continuumCaption).foregroundStyle(.secondary)
+ Text(title).font(.prairieHeadline)
+ Text(subtitle).font(.prairieCaption).foregroundStyle(.secondary)
}
Spacer()
}
@@ -494,8 +494,8 @@ struct CompanionPairingCard: View {
private func progressStep(title: String, subtitle: String) -> some View {
VStack(spacing: 10) {
- Text(title).font(.continuumHeadline)
- Text(subtitle).font(.continuumCaption).foregroundStyle(.secondary)
+ Text(title).font(.prairieHeadline)
+ Text(subtitle).font(.prairieCaption).foregroundStyle(.secondary)
ProgressView().padding(.top, 4)
}
.padding(.vertical, 8)
@@ -503,7 +503,7 @@ struct CompanionPairingCard: View {
private func primaryButton(_ title: String, action: @escaping () -> Void) -> some View {
Button(action: action) {
- Text(title).font(.continuumHeadline).frame(maxWidth: .infinity).padding(.vertical, 6)
+ Text(title).font(.prairieHeadline).frame(maxWidth: .infinity).padding(.vertical, 6)
}
.buttonStyle(.borderedProminent)
.controlSize(.large)
@@ -512,7 +512,7 @@ struct CompanionPairingCard: View {
private func tertiaryButton(_ title: String, action: @escaping () -> Void) -> some View {
Button(action: action) {
- Text(title).font(.continuumBody).frame(maxWidth: .infinity).padding(.vertical, 8)
+ Text(title).font(.prairieBody).frame(maxWidth: .infinity).padding(.vertical, 8)
}
.buttonStyle(.plain)
.foregroundStyle(accent)
diff --git a/docs/superpowers/plans/2026-06-14-companion-pairing.md b/docs/superpowers/plans/2026-06-14-companion-pairing.md
index 972754665..3da8b42c9 100644
--- a/docs/superpowers/plans/2026-06-14-companion-pairing.md
+++ b/docs/superpowers/plans/2026-06-14-companion-pairing.md
@@ -14,7 +14,7 @@
## Decisions locked in during planning (read before starting)
-1. **Pairing networking is isolated from `HTTPClient`.** `HTTPClient`/`ContinuumAPI`/`TokenStore` operate against a single *active* server and have no per-server request API. Rather than rework that, all device-auth calls during pairing go through a new `PairingDeviceAPI` (plain `URLSession`, explicit base URL, optional bearer). This keeps pairing from disturbing the running app's active server.
+1. **Pairing networking is isolated from `HTTPClient`.** `HTTPClient`/`PrairieAPI`/`TokenStore` operate against a single *active* server and have no per-server request API. Rather than rework that, all device-auth calls during pairing go through a new `PairingDeviceAPI` (plain `URLSession`, explicit base URL, optional bearer). This keeps pairing from disturbing the running app's active server.
2. **The phone displays the server-authoritative match code.** After receiving a `userCode` over the channel, the phone calls `GET /auth/device?code=
` (`PairingDeviceAPI.lookup`) and shows the match code **the server** returns for that code — never the match code from the channel. This is what makes the visual compare resistant to a channel MITM (design spec §6).
3. **Persist-on-success.** The TV holds a pushed server URL as a *pending candidate* and writes it to `ServerRegistry` / `TokenStore` only after the poll returns tokens. Any cancel/fail/timeout/drop discards it (design spec §5/§6/§7).
4. **Tests.** The repo has no working XCTest target (the lone `iosApp/Tests/*.swift` file is an orphaned `@main` + `precondition()` script). Per CLAUDE.md ("focused tests only for critical or high-risk behavior") we unit-test only the **pure, dependency-free** logic — `PairingProtocol` and `PairingFrame` — with standalone `swiftc`-compiled `precondition()` programs that mirror the existing pattern. The stateful coordinators are structured against injected protocols and verified by the **manual LAN end-to-end test** (Task 14).
@@ -818,7 +818,7 @@ final class ReceiverPairingCoordinator {
/// True while `pollTask` is active. The protocol is one-server-at-a-time;
/// an overlapping PushServer is ignored.
private var isPolling = false
- private static let logger = Logger(subsystem: "com.continuum.app", category: "pairing.receiver")
+ private static let logger = Logger(subsystem: "org.prairieserver.prairie", category: "pairing.receiver")
/// - Parameter onAuthenticated: called on the main actor after at least
/// one server is signed in, to advance the router to profile selection.
@@ -979,7 +979,7 @@ import OSLog
final class TVPairingAdvertiser {
private var listener: NWListener?
private var busy = false
- private static let logger = Logger(subsystem: "com.continuum.app", category: "pairing.advertiser")
+ private static let logger = Logger(subsystem: "org.prairieserver.prairie", category: "pairing.advertiser")
/// - Parameter onConnection: called on the main actor with an opened
/// session + its inbound stream for the coordinator to drive.
@@ -1166,7 +1166,7 @@ final class CompanionPairingCoordinator {
private var confirmed = false
private var signedIn: [String] = []
private var failed: [String] = []
- private static let logger = Logger(subsystem: "com.continuum.app", category: "pairing.companion")
+ private static let logger = Logger(subsystem: "org.prairieserver.prairie", category: "pairing.companion")
init(api: PairingDeviceAPI = PairingDeviceAPI(), session: PairingSession, stream: AsyncThrowingStream) {
self.api = api
@@ -1631,7 +1631,7 @@ git commit --allow-empty -m "Verify companion pairing end-to-end on LAN"
## Self-Review (completed during planning)
-**Spec coverage:** §4 components → PairingProtocol (T2), PairingSession+frame (T4/T6), ContinuumAPI approve/lookup → PairingDeviceAPI (T7), Receiver coordinator+advertiser+UI (T8/T9), Companion coordinator+browser+banner+view (T10–T13). §5 flow + confirm-once → T10. §6 persist-on-success → T8; server-authoritative match code → T10; opportunistic TLS → T6. §7 edge cases → coordinators + T14. §8 Info.plist/permissions → T1. §9 testing → T3/T5 (pure logic) + T14 (manual). All spec sections map to a task.
+**Spec coverage:** §4 components → PairingProtocol (T2), PairingSession+frame (T4/T6), PrairieAPI approve/lookup → PairingDeviceAPI (T7), Receiver coordinator+advertiser+UI (T8/T9), Companion coordinator+browser+banner+view (T10–T13). §5 flow + confirm-once → T10. §6 persist-on-success → T8; server-authoritative match code → T10; opportunistic TLS → T6. §7 edge cases → coordinators + T14. §8 Info.plist/permissions → T1. §9 testing → T3/T5 (pure logic) + T14 (manual). All spec sections map to a task.
**Type consistency:** `PairingMessage` cases and field names are identical across T2 (definition), T8/T10 (producers/consumers). `PairingSession.open()` returns `AsyncThrowingStream` and is consumed with that exact type in T8–T13. `PairingDeviceAPI` method names (`start/poll/lookup/approve`) match their call sites in T8/T10. `ServerEntry`, `ServerRegistry.{normalize,serverId,addOrUpdate,switchTo,sortedEntries}`, `TokenStore.{getAccessToken(for:),saveTokens,switchActiveServer,setServerUrl}`, `AppRouter.showProfileSelection()`, and `AppleDeviceIdentity.current.{id,name,platform}` all match the verbatim signatures extracted from the codebase.
diff --git a/docs/superpowers/plans/2026-06-15-ios-aurora-onboarding.md b/docs/superpowers/plans/2026-06-15-ios-aurora-onboarding.md
index 173962da7..b5e5cdaf7 100644
--- a/docs/superpowers/plans/2026-06-15-ios-aurora-onboarding.md
+++ b/docs/superpowers/plans/2026-06-15-ios-aurora-onboarding.md
@@ -136,7 +136,7 @@ struct AuroraInputField: View {
)
.shadow(color: isFocused ? Color.auroraAccent.opacity(0.4) : .clear,
radius: isFocused ? 20 : 0, y: 0)
- .animation(ContinuumTheme.springAnimation, value: isFocused)
+ .animation(PrairieTheme.springAnimation, value: isFocused)
}
private var displayString: String {
@@ -229,7 +229,7 @@ import SwiftUI
// MARK: - Field content classification (platform-neutral)
-/// Mirrors the small enum pattern in the old Continuum forms so the shared
+/// Mirrors the small enum pattern in the old Prairie forms so the shared
/// component carries no UIKit types in its signature — macOS has no
/// `UITextContentType`.
enum AuroraFieldContentType { case username, password, email, oneTimeCode, url }
@@ -259,8 +259,8 @@ struct AuroraErrorLabel: View {
Text(text)
.fixedSize(horizontal: false, vertical: true)
}
- .font(.continuumCaption)
- .foregroundStyle(Color.continuumError)
+ .font(.prairieCaption)
+ .foregroundStyle(Color.prairieError)
.frame(maxWidth: .infinity, alignment: .leading)
.transition(.opacity)
}
@@ -338,7 +338,7 @@ struct AuroraTextField: View {
)
.shadow(color: isFocused ? Color.auroraAccent.opacity(0.35) : .clear,
radius: isFocused ? 16 : 0)
- .animation(ContinuumTheme.springAnimation, value: isFocused)
+ .animation(PrairieTheme.springAnimation, value: isFocused)
}
}
@@ -471,7 +471,7 @@ struct ServerSetupView: View {
VStack(spacing: 12) {
AuroraEyebrow(text: "Step 01 — Connect", centered: true)
Text("Add your server")
- .font(.continuumTitle)
+ .font(.prairieTitle)
.foregroundStyle(Color.auroraInk)
}
.frame(maxWidth: .infinity)
@@ -519,7 +519,7 @@ struct ServerSetupView: View {
@ViewBuilder
private var advancedDisclosure: some View {
Button {
- withAnimation(ContinuumTheme.springAnimation) {
+ withAnimation(PrairieTheme.springAnimation) {
viewModel.showsAdvancedOptions.toggle()
}
} label: {
@@ -636,7 +636,7 @@ with:
```swift
Button {
- withAnimation(ContinuumTheme.springAnimation) {
+ withAnimation(PrairieTheme.springAnimation) {
viewModel.showsAdvancedOptions.toggle()
}
} label: {
@@ -681,7 +681,7 @@ On `manualCard`, add an animation for the toggle next to the existing error anim
to:
```swift
.animation(.easeInOut(duration: 0.2), value: viewModel.error)
- .animation(ContinuumTheme.springAnimation, value: viewModel.showsAdvancedOptions)
+ .animation(PrairieTheme.springAnimation, value: viewModel.showsAdvancedOptions)
```
- [ ] **Step 4: Build tvOS**
@@ -731,7 +731,7 @@ struct LoginView: View {
VStack(spacing: 12) {
AuroraEyebrow(text: "Step 02 — Sign in", centered: true)
Text("Welcome back")
- .font(.continuumTitle)
+ .font(.prairieTitle)
.foregroundStyle(Color.auroraInk)
if let host = hostLabel {
Text(host)
@@ -865,7 +865,7 @@ struct SignupView: View {
VStack(spacing: 12) {
AuroraEyebrow(text: "Create account", centered: true)
Text("Create your account")
- .font(.continuumTitle)
+ .font(.prairieTitle)
.foregroundStyle(Color.auroraInk)
.multilineTextAlignment(.center)
}
@@ -965,7 +965,7 @@ In `background`, replace the `#else` branch:
```swift
#else
ZStack {
- Color.continuumBackground.ignoresSafeArea()
+ Color.prairieBackground.ignoresSafeArea()
RadialGradient(
colors: [Color.white.opacity(0.07), Color.black.opacity(0)],
center: .center,
@@ -1086,11 +1086,11 @@ struct ServerNeedsSetupView: View {
VStack(spacing: 12) {
Text("Finish setup in your browser")
- .font(.continuumTitle)
+ .font(.prairieTitle)
.foregroundStyle(Color.auroraInk)
.multilineTextAlignment(.center)
Text("This server doesn't have an account yet. Open it in a browser to create the first one, then come back here to sign in.")
- .font(.continuumBody)
+ .font(.prairieBody)
.foregroundStyle(Color.auroraInkSecondary)
.multilineTextAlignment(.center)
.fixedSize(horizontal: false, vertical: true)
@@ -1233,7 +1233,7 @@ In `iosApp/iosApp/ContentView.swift`, replace the whole `destinationView(for:)`
title: "Finish setup in your browser",
subtitle: nil
)
- .continuumBackground()
+ .prairieBackground()
#else
ServerNeedsSetupView(router: router)
#endif
@@ -1244,7 +1244,7 @@ In `iosApp/iosApp/ContentView.swift`, replace the whole `destinationView(for:)`
title: "Sign up from a phone or the web",
subtitle: nil
)
- .continuumBackground()
+ .prairieBackground()
#else
SignupView(router: router)
#endif
@@ -1262,7 +1262,7 @@ In `iosApp/iosApp/ContentView.swift`, replace the whole `destinationView(for:)`
title: "Coming Soon",
subtitle: "This screen is under construction."
)
- .continuumBackground()
+ .prairieBackground()
}
}
```
@@ -1278,7 +1278,7 @@ with:
case .serverNeedsSetup:
#if os(tvOS)
EmptyStateView(icon: "gearshape.2", title: "Finish setup in your browser", subtitle: nil)
- .continuumBackground()
+ .prairieBackground()
#else
ServerNeedsSetupView(router: router)
#endif
@@ -1289,7 +1289,7 @@ And gate the `.signup` arm in `profileFlowDestination` the same way (it currentl
case .signup:
#if os(tvOS)
EmptyStateView(icon: "person.badge.plus", title: "Sign up from a phone or the web", subtitle: nil)
- .continuumBackground()
+ .prairieBackground()
#else
SignupView(router: router)
#endif
@@ -1346,7 +1346,7 @@ Expected: `** BUILD SUCCEEDED **` for all three.
- [ ] **Step 2: Run the iOS app in the simulator and walk the flow**
Boot the iPhone simulator, install, and launch the `Prairie` scheme. Verify visually:
-- **Server setup**: plum Aurora backdrop with drifting ribbons + starfield, `SILO.` wordmark, "Step 01 — Connect" gold eyebrow, single glass form, "Advanced options" collapsed by default; expanding reveals Protocol + Port. Enter a known dev server and connect.
+- **Server setup**: plum Aurora backdrop with drifting ribbons + starfield, `PRAIRIE.` wordmark, "Step 01 — Connect" gold eyebrow, single glass form, "Advanced options" collapsed by default; expanding reveals Protocol + Port. Enter a known dev server and connect.
- **Sign in**: "Step 02 — Sign in" + "Welcome back" + host label; username/password with a working eye toggle; keyboard pushes the focused field into view (form scrolls); "Create account" appears only when signup is enabled; "Change server" returns to server setup.
- **Profile**: "Who's watching?" over the Aurora backdrop; tiles tappable; a PIN profile presents the PIN sheet; "Switch server"/"Sign out" chips work.
- **Sign up** (if the dev server allows it): all fields render and scroll; create-account works.
diff --git a/docs/superpowers/plans/2026-06-15-resume-first-home.md b/docs/superpowers/plans/2026-06-15-resume-first-home.md
index a74cc50a9..5b1e22b00 100644
--- a/docs/superpowers/plans/2026-06-15-resume-first-home.md
+++ b/docs/superpowers/plans/2026-06-15-resume-first-home.md
@@ -63,7 +63,7 @@ In `HomeView.swift`, inside the `#if !os(tvOS)` state block, delete the three he
```swift
// DELETE these three lines:
- @State private var heroTintColor: Color = .continuumBackground
+ @State private var heroTintColor: Color = .prairieBackground
@State private var heroBackdropURL: String?
@State private var heroBackdropThumbhash: String?
```
@@ -87,7 +87,7 @@ In `HomeView.swift`, in the non-tvOS `body` (the `#else` branch), the `ZStack(al
```swift
ZStack(alignment: .top) {
- Color.continuumBackground
+ Color.prairieBackground
.ignoresSafeArea()
Group {
@@ -147,7 +147,7 @@ In `HomeView.swift`, replace the body of `scrollContent`'s `LazyVStack` so there
.id(HomeFocusTarget.row(section.id))
}
}
- .padding(.bottom, ContinuumTheme.largePadding)
+ .padding(.bottom, PrairieTheme.largePadding)
```
Update the `HomeFocusTarget` enum to drop the featured case and rename the spacer:
@@ -163,8 +163,8 @@ Rename the helper `noFeaturedTopSpacing(topSafeAreaInset:)` to `topRunwaySpacing
```swift
private func topRunwaySpacing(topSafeAreaInset: CGFloat) -> CGFloat {
- let headerContentHeight: CGFloat = 40 + (ContinuumTheme.smallPadding * 2)
- return topSafeAreaInset + headerContentHeight + ContinuumTheme.largePadding + ContinuumTheme.smallPadding
+ let headerContentHeight: CGFloat = 40 + (PrairieTheme.smallPadding * 2)
+ return topSafeAreaInset + headerContentHeight + PrairieTheme.largePadding + PrairieTheme.smallPadding
}
```
@@ -221,7 +221,7 @@ In `BrowseView.swift`, in `LibraryRecommendedView`'s `content`, delete the entir
```swift
private var content: some View {
ScrollView(.vertical, showsIndicators: false) {
- LazyVStack(spacing: ContinuumTheme.largePadding) {
+ LazyVStack(spacing: PrairieTheme.largePadding) {
ForEach(viewModel.regularSections) { section in
SectionRow(
section: section,
@@ -229,7 +229,7 @@ In `BrowseView.swift`, in `LibraryRecommendedView`'s `content`, delete the entir
)
}
}
- .padding(.bottom, ContinuumTheme.largePadding)
+ .padding(.bottom, PrairieTheme.largePadding)
}
// Report the distance scrolled from the resting top position. We add
// the top content inset so the value starts at 0 at rest regardless
@@ -250,7 +250,7 @@ In `BrowseView.swift`, `extendsBackdropToTop` is now used only by `refreshStatus
```swift
private var refreshStatusTopPadding: CGFloat {
- ContinuumTheme.padding
+ PrairieTheme.padding
}
```
diff --git a/docs/superpowers/plans/2026-06-15-tvos-detail-redesign.md b/docs/superpowers/plans/2026-06-15-tvos-detail-redesign.md
index 1b3009094..56a2b427e 100644
--- a/docs/superpowers/plans/2026-06-15-tvos-detail-redesign.md
+++ b/docs/superpowers/plans/2026-06-15-tvos-detail-redesign.md
@@ -6,7 +6,7 @@
**Architecture:** A view-layer change on the existing `TVDetailHero` + per-type detail views. Today's round controls (`Capsule` pills, `Circle` icon buttons, capsule season chips) are reshaped to one 8 pt rounded-rectangle family. A new `TVPlaybackSelectorRow` consolidates the version picker and the audio/subtitle menus (which already exist in the `⋯` menu) into a webapp-parity row, and adds an Edition selector derived from `FileVersion.edition`. The `ReadableFocusSection` focus workaround is removed; the synopsis becomes an expand-in-place control. The audiobook page gets a cover-forward cinematic hero.
-**Tech Stack:** Swift 5 / SwiftUI, tvOS. XcodeGen (`project.yml` → `Prairie.xcodeproj`). Design tokens in `ContinuumTheme.swift`.
+**Tech Stack:** Swift 5 / SwiftUI, tvOS. XcodeGen (`project.yml` → `Prairie.xcodeproj`). Design tokens in `PrairieTheme.swift`.
---
@@ -14,7 +14,7 @@
**Read before starting any task.**
-- **Design language:** Skyline — OLED black, monochrome chrome, white-at-opacity. Squared-control radius = `ContinuumTheme.smallCornerRadius` (8 pt). Spec: `docs/superpowers/specs/2026-06-15-tvos-detail-redesign-design.md`. Mockups: `docs/tvos-detail-mockups/`.
+- **Design language:** Skyline — OLED black, monochrome chrome, white-at-opacity. Squared-control radius = `PrairieTheme.smallCornerRadius` (8 pt). Spec: `docs/superpowers/specs/2026-06-15-tvos-detail-redesign-design.md`. Mockups: `docs/tvos-detail-mockups/`.
- **TDD reconciliation (important):** `CLAUDE.md` says *do not add tests for UI changes* — only focused tests for critical/high-risk shared logic. So **only Task 3 (edition grouping) is test-first.** Every other task is **build-and-verify**: make the change, build `PrairieTV`, then visually confirm in the tvOS Simulator (`admin` / `water1234` per the PrairieTV debugging notes).
- **Build gate (run after every task, must succeed):**
```bash
@@ -86,17 +86,17 @@ to:
```swift
.overlay(
- RoundedRectangle(cornerRadius: ContinuumTheme.smallCornerRadius, style: .continuous).stroke(
+ RoundedRectangle(cornerRadius: PrairieTheme.smallCornerRadius, style: .continuous).stroke(
innerBorderColor,
lineWidth: innerBorderWidth
)
)
.background(
- RoundedRectangle(cornerRadius: ContinuumTheme.smallCornerRadius, style: .continuous).fill(background)
+ RoundedRectangle(cornerRadius: PrairieTheme.smallCornerRadius, style: .continuous).fill(background)
)
.overlay {
if isFocused {
- RoundedRectangle(cornerRadius: ContinuumTheme.smallCornerRadius + 2, style: .continuous)
+ RoundedRectangle(cornerRadius: PrairieTheme.smallCornerRadius + 2, style: .continuous)
.stroke(focusOutlineColor, lineWidth: focusOutlineWidth)
.padding(-focusOutlineInset)
}
@@ -130,19 +130,19 @@ to:
```swift
.background(
- RoundedRectangle(cornerRadius: ContinuumTheme.smallCornerRadius, style: .continuous).fill(
+ RoundedRectangle(cornerRadius: PrairieTheme.smallCornerRadius, style: .continuous).fill(
isFocused ? .white : Color.white.opacity(0.10)
)
)
.overlay(
- RoundedRectangle(cornerRadius: ContinuumTheme.smallCornerRadius, style: .continuous).stroke(
+ RoundedRectangle(cornerRadius: PrairieTheme.smallCornerRadius, style: .continuous).stroke(
isFocused ? Color.black.opacity(0.12) : Color.white.opacity(0.34),
lineWidth: isFocused ? 1.6 : 1.4
)
)
.overlay {
if isFocused {
- RoundedRectangle(cornerRadius: ContinuumTheme.smallCornerRadius + 2, style: .continuous)
+ RoundedRectangle(cornerRadius: PrairieTheme.smallCornerRadius + 2, style: .continuous)
.stroke(Color.white.opacity(0.96), lineWidth: 3)
.padding(-5)
}
@@ -161,9 +161,9 @@ to:
to:
```swift
- .background(RoundedRectangle(cornerRadius: ContinuumTheme.smallCornerRadius, style: .continuous).fill(Color.black.opacity(0.42)))
+ .background(RoundedRectangle(cornerRadius: PrairieTheme.smallCornerRadius, style: .continuous).fill(Color.black.opacity(0.42)))
.overlay(
- RoundedRectangle(cornerRadius: ContinuumTheme.smallCornerRadius, style: .continuous).stroke(Color.white.opacity(0.16), lineWidth: 1.2)
+ RoundedRectangle(cornerRadius: PrairieTheme.smallCornerRadius, style: .continuous).stroke(Color.white.opacity(0.16), lineWidth: 1.2)
)
```
@@ -190,11 +190,11 @@ Co-Authored-By: Claude Opus 4.8 "
@ViewBuilder
private var background: some View {
if isSelected {
- RoundedRectangle(cornerRadius: ContinuumTheme.smallCornerRadius, style: .continuous).fill(Color.white)
+ RoundedRectangle(cornerRadius: PrairieTheme.smallCornerRadius, style: .continuous).fill(Color.white)
} else if isFocused {
- RoundedRectangle(cornerRadius: ContinuumTheme.smallCornerRadius, style: .continuous).fill(Color.white.opacity(0.18))
+ RoundedRectangle(cornerRadius: PrairieTheme.smallCornerRadius, style: .continuous).fill(Color.white.opacity(0.18))
} else {
- RoundedRectangle(cornerRadius: ContinuumTheme.smallCornerRadius, style: .continuous).stroke(Color.white.opacity(0.25), lineWidth: 1.5)
+ RoundedRectangle(cornerRadius: PrairieTheme.smallCornerRadius, style: .continuous).stroke(Color.white.opacity(0.25), lineWidth: 1.5)
}
}
```
@@ -704,7 +704,7 @@ struct TVExpandableSynopsis: View {
.contentShape(Rectangle())
}
.buttonStyle(TVSynopsisButtonStyle())
- .animation(.easeOut(duration: ContinuumTheme.normalDuration), value: expanded)
+ .animation(.easeOut(duration: PrairieTheme.normalDuration), value: expanded)
}
}
@@ -721,13 +721,13 @@ private struct TVSynopsisButtonStyle: ButtonStyle {
.padding(.horizontal, 20)
.padding(.vertical, 14)
.background(
- RoundedRectangle(cornerRadius: ContinuumTheme.smallCornerRadius, style: .continuous)
- .fill(Color.continuumSurfaceElevated.opacity(isFocused ? 0.55 : 0))
+ RoundedRectangle(cornerRadius: PrairieTheme.smallCornerRadius, style: .continuous)
+ .fill(Color.prairieSurfaceElevated.opacity(isFocused ? 0.55 : 0))
)
.padding(.horizontal, -20)
.padding(.vertical, -14)
.focusEffectDisabled()
- .animation(.easeOut(duration: ContinuumTheme.fastDuration), value: isFocused)
+ .animation(.easeOut(duration: PrairieTheme.fastDuration), value: isFocused)
}
}
}
@@ -876,7 +876,7 @@ to:
.frame(maxWidth: 900, alignment: .leading)
Spacer(minLength: 0)
}
- .padding(.horizontal, ContinuumTheme.safePadding)
+ .padding(.horizontal, PrairieTheme.safePadding)
.padding(.bottom, 64)
.padding(.top, 120)
}
@@ -902,13 +902,13 @@ to:
.blur(radius: 60)
.opacity(0.5)
} else {
- Color.continuumSurface.frame(height: 760)
+ Color.prairieSurface.frame(height: 760)
}
LinearGradient(
stops: [
- .init(color: Color.continuumBackground.opacity(0.55), location: 0.0),
- .init(color: Color.continuumBackground.opacity(0.30), location: 0.5),
- .init(color: Color.continuumBackground, location: 1.0),
+ .init(color: Color.prairieBackground.opacity(0.55), location: 0.0),
+ .init(color: Color.prairieBackground.opacity(0.30), location: 0.5),
+ .init(color: Color.prairieBackground, location: 1.0),
],
startPoint: .top, endPoint: .bottom
)
@@ -963,7 +963,7 @@ Co-Authored-By: Claude Opus 4.8 "
```swift
.background(
- RoundedRectangle(cornerRadius: ContinuumTheme.smallCornerRadius, style: .continuous)
+ RoundedRectangle(cornerRadius: PrairieTheme.smallCornerRadius, style: .continuous)
.fill(isFocused ? Color.white : Color.white.opacity(0.06))
)
```
@@ -1038,10 +1038,10 @@ Co-Authored-By: Claude Opus 4.8 "
```
and change the modifier to:
```swift
- .animation(reduceMotion ? nil : .easeOut(duration: ContinuumTheme.normalDuration), value: expanded)
+ .animation(reduceMotion ? nil : .easeOut(duration: PrairieTheme.normalDuration), value: expanded)
```
-- [ ] **Step 2: Confirm the squared button/chip focus already respects Reduce Motion** or is acceptable (the existing styles animate `isFocused` via `ContinuumTheme.springAnimation`; leave as-is unless it visibly janks — these predate this redesign).
+- [ ] **Step 2: Confirm the squared button/chip focus already respects Reduce Motion** or is acceptable (the existing styles animate `isFocused` via `PrairieTheme.springAnimation`; leave as-is unless it visibly janks — these predate this redesign).
- [ ] **Step 3: Full build gate.** Expected: `** BUILD SUCCEEDED **`.
diff --git a/docs/superpowers/plans/2026-06-16-cast-ui-redesign.md b/docs/superpowers/plans/2026-06-16-cast-ui-redesign.md
index 0a22220f9..f9e0d88a3 100644
--- a/docs/superpowers/plans/2026-06-16-cast-ui-redesign.md
+++ b/docs/superpowers/plans/2026-06-16-cast-ui-redesign.md
@@ -6,7 +6,7 @@
**Architecture:** Pure iOS view-layer change. `PrairieCastViews.swift` is split into four focused, `#if os(iOS)`-guarded files under `iosApp/iosApp/Cast/iOS/`. Artwork is resolved client-side from the `contentId` already in the cast state (cache → API), so no protocol field is added. The remote screen is split into a thin controller-observing wrapper plus a pure presentational view driven by plain `PrairieCastPlaybackState` + a command callback, which makes it previewable with mock data.
-**Tech Stack:** Swift 5, SwiftUI, `@Observable`, XcodeGen (`project.yml`), existing app primitives (`AsyncImageView`, `PlayerTimeFormatter`, `ContinuumAPI`, `ResponseCache`, `Color.continuum*` tokens).
+**Tech Stack:** Swift 5, SwiftUI, `@Observable`, XcodeGen (`project.yml`), existing app primitives (`AsyncImageView`, `PlayerTimeFormatter`, `PrairieAPI`, `ResponseCache`, `Color.prairie*` tokens).
---
@@ -33,7 +33,7 @@ The artwork resolver is low-risk network/cache glue (not critical/high-risk shar
```
- **`Prairie.xcodeproj` is gitignored** (XcodeGen output) — never `git add` it. Commit only the Swift/doc files.
- **Every new file under `Cast/iOS/` MUST be wrapped in `#if os(iOS) … #endif`** — the tvOS (`PrairieTV`) target also globs `iosApp/` and will otherwise try to compile iOS-only types.
-- **Monochrome chrome** (spec §3): no chromatic accent. White (`continuumOnSurface`) fills, black (`continuumBackground`) glyph on the play button; artwork is the only color.
+- **Monochrome chrome** (spec §3): no chromatic accent. White (`prairieOnSurface`) fills, black (`prairieBackground`) glyph on the play button; artwork is the only color.
## File structure (decomposition)
@@ -85,7 +85,7 @@ final class PrairieCastArtworkResolver {
}
do {
- let detail = try await ContinuumAPI.shared.itemDetail(contentId: contentId)
+ let detail = try await PrairieAPI.shared.itemDetail(contentId: contentId)
apply(detail, contentId: contentId)
} catch {
// Degrade silently: the remote simply shows the flat background.
@@ -106,7 +106,7 @@ struct PrairieCastArtworkBackground: View {
var body: some View {
ZStack {
- Color.continuumBackground
+ Color.prairieBackground
if let urlString, !urlString.isEmpty {
AsyncImageView(url: urlString, contentMode: .fill, placeholderStyle: .clear)
.id(urlString)
@@ -114,7 +114,7 @@ struct PrairieCastArtworkBackground: View {
.opacity(0.45)
.clipped()
}
- Color.continuumBackground.opacity(0.55)
+ Color.prairieBackground.opacity(0.55)
}
.ignoresSafeArea()
}
@@ -234,21 +234,21 @@ struct PrairieCastRemoteControlView: View {
private var connectingView: some View {
VStack(spacing: 18) {
RoundedRectangle(cornerRadius: 16, style: .continuous)
- .fill(Color.continuumSurfaceElevated)
+ .fill(Color.prairieSurfaceElevated)
.frame(width: 150, height: 216)
if let error = controller.errorMessage, !error.isEmpty {
Text(error)
.font(.subheadline)
- .foregroundStyle(Color.continuumOnSurface)
+ .foregroundStyle(Color.prairieOnSurface)
.multilineTextAlignment(.center)
.padding(.horizontal, 14)
.padding(.vertical, 10)
- .background(RoundedRectangle(cornerRadius: 12, style: .continuous).fill(Color.continuumError.opacity(0.9)))
+ .background(RoundedRectangle(cornerRadius: 12, style: .continuous).fill(Color.prairieError.opacity(0.9)))
} else {
ProgressView()
Text("Connecting to \(controller.activeTarget?.name ?? "Prairie TV")…")
.font(.headline)
- .foregroundStyle(Color.continuumSecondaryText)
+ .foregroundStyle(Color.prairieSecondaryText)
}
}
.padding(24)
@@ -292,12 +292,12 @@ private struct RemoteNowPlayingContent: View {
AsyncImageView(url: posterURL, contentMode: .fit)
} else {
RoundedRectangle(cornerRadius: 16, style: .continuous)
- .fill(Color.continuumSurfaceElevated)
+ .fill(Color.prairieSurfaceElevated)
.aspectRatio(2.0 / 3.0, contentMode: .fit)
.overlay {
Image(systemName: "tv")
.font(.system(size: 36))
- .foregroundStyle(Color.continuumSecondaryText)
+ .foregroundStyle(Color.prairieSecondaryText)
}
}
}
@@ -312,13 +312,13 @@ private struct RemoteNowPlayingContent: View {
.font(.title2.weight(.semibold))
.multilineTextAlignment(.center)
.lineLimit(2)
- .foregroundStyle(Color.continuumOnSurface)
+ .foregroundStyle(Color.prairieOnSurface)
if let subtitle = state.subtitle, !subtitle.isEmpty {
Text(subtitle)
.font(.subheadline)
.multilineTextAlignment(.center)
.lineLimit(2)
- .foregroundStyle(Color.continuumSecondaryText)
+ .foregroundStyle(Color.prairieSecondaryText)
}
}
}
@@ -332,10 +332,10 @@ private struct RemoteNowPlayingContent: View {
Text("Playing on \(targetName)")
.font(.caption.weight(.medium))
}
- .foregroundStyle(Color.continuumSecondaryText)
+ .foregroundStyle(Color.prairieSecondaryText)
.padding(.horizontal, 12)
.padding(.vertical, 6)
- .background(Capsule().fill(Color.continuumChromeRestingFill))
+ .background(Capsule().fill(Color.prairieChromeRestingFill))
}
}
@@ -353,7 +353,7 @@ private struct RemoteNowPlayingContent: View {
self.scrubPreview = nil
}
)
- .tint(Color.continuumOnSurface)
+ .tint(Color.prairieOnSurface)
.disabled(state.duration <= 0)
.accessibilityLabel("Playback position")
@@ -363,7 +363,7 @@ private struct RemoteNowPlayingContent: View {
Text(remainingLabel)
}
.font(.caption.monospacedDigit())
- .foregroundStyle(Color.continuumSecondaryText)
+ .foregroundStyle(Color.prairieSecondaryText)
}
}
@@ -386,13 +386,13 @@ private struct RemoteNowPlayingContent: View {
onCommand(.playPause)
} label: {
ZStack {
- Circle().fill(Color.continuumOnSurface).frame(width: 64, height: 64)
+ Circle().fill(Color.prairieOnSurface).frame(width: 64, height: 64)
if state.isLoading || state.isBuffering {
- ProgressView().tint(Color.continuumBackground)
+ ProgressView().tint(Color.prairieBackground)
} else {
Image(systemName: state.isPlaying ? "pause.fill" : "play.fill")
.font(.system(size: 28, weight: .medium))
- .foregroundStyle(Color.continuumBackground)
+ .foregroundStyle(Color.prairieBackground)
}
}
}
@@ -406,7 +406,7 @@ private struct RemoteNowPlayingContent: View {
}
.accessibilityLabel("Forward 30 seconds")
}
- .foregroundStyle(Color.continuumOnSurface)
+ .foregroundStyle(Color.prairieOnSurface)
.buttonStyle(.plain)
}
@@ -503,12 +503,12 @@ private struct RemoteNowPlayingContent: View {
private func errorBanner(_ message: String) -> some View {
Text(message)
.font(.footnote)
- .foregroundStyle(Color.continuumOnSurface)
+ .foregroundStyle(Color.prairieOnSurface)
.multilineTextAlignment(.center)
.frame(maxWidth: .infinity)
.padding(.vertical, 10)
.padding(.horizontal, 14)
- .background(RoundedRectangle(cornerRadius: 12, style: .continuous).fill(Color.continuumError.opacity(0.9)))
+ .background(RoundedRectangle(cornerRadius: 12, style: .continuous).fill(Color.prairieError.opacity(0.9)))
}
}
@@ -523,7 +523,7 @@ private struct RemoteChipLabel: View {
Text(caption)
.font(.caption2)
}
- .foregroundStyle(Color.continuumOnSurface.opacity(0.9))
+ .foregroundStyle(Color.prairieOnSurface.opacity(0.9))
.frame(maxWidth: .infinity)
.contentShape(Rectangle())
}
@@ -622,7 +622,7 @@ struct PrairieCastTargetPickerView: View {
searchingState
}
}
- .background(Color.continuumBackground.ignoresSafeArea())
+ .background(Color.prairieBackground.ignoresSafeArea())
.navigationTitle("Cast")
.navigationBarTitleDisplayMode(.inline)
.toolbar {
@@ -645,7 +645,7 @@ struct PrairieCastTargetPickerView: View {
ProgressView()
Text("Searching for Prairie TVs…")
.font(.headline)
- .foregroundStyle(Color.continuumSecondaryText)
+ .foregroundStyle(Color.prairieSecondaryText)
}
.frame(maxWidth: .infinity, maxHeight: .infinity)
}
@@ -673,16 +673,16 @@ struct PrairieCastTargetPickerView: View {
HStack(spacing: 12) {
Image(systemName: "tv")
.font(.title3)
- .foregroundStyle(Color.continuumOnSurface)
+ .foregroundStyle(Color.prairieOnSurface)
.frame(width: 38, height: 38)
- .background(Circle().fill(Color.continuumChromeRestingFill))
+ .background(Circle().fill(Color.prairieChromeRestingFill))
VStack(alignment: .leading, spacing: 3) {
Text(target.name).font(.headline)
if let serverName = target.serverName {
Text(serverName)
.font(.subheadline)
- .foregroundStyle(Color.continuumSecondaryText)
+ .foregroundStyle(Color.prairieSecondaryText)
}
}
@@ -695,7 +695,7 @@ struct PrairieCastTargetPickerView: View {
.contentShape(Rectangle())
}
.buttonStyle(.plain)
- .listRowBackground(Color.continuumSurface)
+ .listRowBackground(Color.prairieSurface)
}
.scrollContentBackground(.hidden)
}
@@ -781,13 +781,13 @@ struct PrairieCastControlModeButton: View {
private func buttonLabel(isActive: Bool) -> some View {
Image(systemName: "airplayvideo")
.font(.system(size: 17, weight: .semibold))
- .foregroundStyle(isActive ? Color.continuumBackground : Color.continuumOnSurface)
+ .foregroundStyle(isActive ? Color.prairieBackground : Color.prairieOnSurface)
.frame(width: 40, height: 40)
.background {
- Circle().fill(isActive ? Color.continuumOnSurface : Color.continuumChromeRestingFill)
+ Circle().fill(isActive ? Color.prairieOnSurface : Color.prairieChromeRestingFill)
}
.overlay {
- Circle().stroke(isActive ? Color.clear : Color.continuumOutline, lineWidth: 1)
+ Circle().stroke(isActive ? Color.clear : Color.prairieOutline, lineWidth: 1)
}
.contentShape(Circle())
}
@@ -799,7 +799,7 @@ struct PrairieCastControlModeButton: View {
PrairieCastControlModeButton(controller: PrairieCastController(), onChooseTarget: {})
}
.padding()
- .background(Color.continuumBackground)
+ .background(Color.prairieBackground)
}
#endif
#endif
@@ -881,6 +881,6 @@ Expected: clean working tree for the cast files; `Prairie.xcodeproj` does not ap
**2. Placeholder scan:** No TBD/TODO/"handle errors"/"similar to". Every code step is complete and compilable.
-**3. Type consistency:** `PrairieCastArtworkResolver.resolve(contentId:)` / `.posterURL` / `.backdropURL`; `PrairieCastArtworkBackground(urlString:)`; `RemoteNowPlayingContent(state:targetName:posterURL:onCommand:)`; `RemoteChipLabel(systemImage:caption:)`; `PrairieCastPlaybackState.previewPlaying()` — all used consistently across tasks. Command factories (`.seek`, `.playPause`, `.stop`, `.selectAudioTrack`, `.selectSubtitleTrack`, `.setPlaybackSpeed`, `.setQuality`, `.setVideoGravity`, `.setHDREnabled`) match `PrairieCastControlCommand`. State fields match `PrairieCastPlaybackState`. `VideoGravity.allCases`/`.label`/`.rawValue`, `ResponseCache.shared.get`/`CacheKey.itemDetail`, `ContinuumAPI.shared.itemDetail(contentId:)`/`ItemDetail.posterUrl`/`.backdropUrl`, `AsyncImageView(url:contentMode:placeholderStyle:)`, `PlayerTimeFormatter.formatHMS` — all verified against the codebase.
+**3. Type consistency:** `PrairieCastArtworkResolver.resolve(contentId:)` / `.posterURL` / `.backdropURL`; `PrairieCastArtworkBackground(urlString:)`; `RemoteNowPlayingContent(state:targetName:posterURL:onCommand:)`; `RemoteChipLabel(systemImage:caption:)`; `PrairieCastPlaybackState.previewPlaying()` — all used consistently across tasks. Command factories (`.seek`, `.playPause`, `.stop`, `.selectAudioTrack`, `.selectSubtitleTrack`, `.setPlaybackSpeed`, `.setQuality`, `.setVideoGravity`, `.setHDREnabled`) match `PrairieCastControlCommand`. State fields match `PrairieCastPlaybackState`. `VideoGravity.allCases`/`.label`/`.rawValue`, `ResponseCache.shared.get`/`CacheKey.itemDetail`, `PrairieAPI.shared.itemDetail(contentId:)`/`ItemDetail.posterUrl`/`.backdropUrl`, `AsyncImageView(url:contentMode:placeholderStyle:)`, `PlayerTimeFormatter.formatHMS` — all verified against the codebase.
No gaps found.
diff --git a/docs/superpowers/plans/2026-06-16-ios-tvos-cast-remote-improvements.md b/docs/superpowers/plans/2026-06-16-ios-tvos-cast-remote-improvements.md
index 050368fae..f1cc37999 100644
--- a/docs/superpowers/plans/2026-06-16-ios-tvos-cast-remote-improvements.md
+++ b/docs/superpowers/plans/2026-06-16-ios-tvos-cast-remote-improvements.md
@@ -880,14 +880,14 @@ Replace `content` in `PrairieCastRemoteControlView` with:
VStack(spacing: 18) {
Image(systemName: "airplayvideo")
.font(.system(size: 44, weight: .medium))
- .foregroundStyle(Color.continuumOnSurface)
+ .foregroundStyle(Color.prairieOnSurface)
Text("Connected to \(controller.activeTarget?.name ?? "Prairie TV")")
.font(.title3.weight(.semibold))
- .foregroundStyle(Color.continuumOnSurface)
+ .foregroundStyle(Color.prairieOnSurface)
Text("Pick something from your library to start playing.")
.font(.subheadline)
.multilineTextAlignment(.center)
- .foregroundStyle(Color.continuumSecondaryText)
+ .foregroundStyle(Color.prairieSecondaryText)
}
.padding(32)
}
@@ -895,7 +895,7 @@ Replace `content` in `PrairieCastRemoteControlView` with:
private func statusView(title: String, showSpinner: Bool) -> some View {
VStack(spacing: 14) {
if showSpinner { ProgressView() }
- Text(title).font(.headline).foregroundStyle(Color.continuumSecondaryText)
+ Text(title).font(.headline).foregroundStyle(Color.prairieSecondaryText)
}
.padding(32)
}
@@ -938,7 +938,7 @@ Wrap the scrubber + time labels in a `TimelineView(.periodic(from: .now, by: 0.2
self.scrubPreview = nil
}
)
- .tint(Color.continuumOnSurface)
+ .tint(Color.prairieOnSurface)
.disabled(state.duration <= 0)
.accessibilityLabel("Playback position")
.accessibilityValue(PlayerTimeFormatter.formatHMS(live))
@@ -949,7 +949,7 @@ Wrap the scrubber + time labels in a `TimelineView(.periodic(from: .now, by: 0.2
Text(remainingLabel(live: live))
}
.font(.caption.monospacedDigit())
- .foregroundStyle(Color.continuumSecondaryText)
+ .foregroundStyle(Color.prairieSecondaryText)
}
}
}
@@ -994,11 +994,11 @@ Add:
),
in: 0...1
)
- .tint(Color.continuumOnSurface)
+ .tint(Color.prairieOnSurface)
.accessibilityLabel("Volume")
.accessibilityValue("\(Int((state.isMuted ? 0 : state.volume) * 100)) percent")
}
- .foregroundStyle(Color.continuumOnSurface)
+ .foregroundStyle(Color.prairieOnSurface)
.buttonStyle(.plain)
}
```
@@ -1064,7 +1064,7 @@ struct PrairieCastMiniBar: View {
.lineLimit(1)
Text("Playing on \(controller.activeTarget?.name ?? "Prairie TV")")
.font(.caption)
- .foregroundStyle(Color.continuumSecondaryText)
+ .foregroundStyle(Color.prairieSecondaryText)
.lineLimit(1)
}
Spacer(minLength: 8)
@@ -1082,8 +1082,8 @@ struct PrairieCastMiniBar: View {
.padding(.vertical, 8)
.background(.ultraThinMaterial, in: RoundedRectangle(cornerRadius: 14, style: .continuous))
.overlay(RoundedRectangle(cornerRadius: 14, style: .continuous)
- .stroke(Color.continuumOutline, lineWidth: 1))
- .foregroundStyle(Color.continuumOnSurface)
+ .stroke(Color.prairieOutline, lineWidth: 1))
+ .foregroundStyle(Color.prairieOnSurface)
.contentShape(Rectangle())
}
.buttonStyle(.plain)
@@ -1103,9 +1103,9 @@ struct PrairieCastMiniBar: View {
.clipShape(RoundedRectangle(cornerRadius: 6, style: .continuous))
} else {
RoundedRectangle(cornerRadius: 6, style: .continuous)
- .fill(Color.continuumSurfaceElevated)
+ .fill(Color.prairieSurfaceElevated)
.frame(width: 34, height: 50)
- .overlay { Image(systemName: "tv").foregroundStyle(Color.continuumSecondaryText) }
+ .overlay { Image(systemName: "tv").foregroundStyle(Color.prairieSecondaryText) }
}
}
}
diff --git a/docs/superpowers/plans/2026-06-16-now-playing-shelf.md b/docs/superpowers/plans/2026-06-16-now-playing-shelf.md
index ff897af9a..606c53b8e 100644
--- a/docs/superpowers/plans/2026-06-16-now-playing-shelf.md
+++ b/docs/superpowers/plans/2026-06-16-now-playing-shelf.md
@@ -61,7 +61,7 @@ struct NowPlayingBarChrome: ViewModifier {
.background(.ultraThinMaterial, in: RoundedRectangle(cornerRadius: 14, style: .continuous))
.overlay(
RoundedRectangle(cornerRadius: 14, style: .continuous)
- .strokeBorder(Color.continuumOutline, lineWidth: 1)
+ .strokeBorder(Color.prairieOutline, lineWidth: 1)
)
case .accessory:
content
@@ -87,8 +87,8 @@ Then replace the chrome chain. Change:
.padding(.vertical, 8)
.background(.ultraThinMaterial, in: RoundedRectangle(cornerRadius: 14, style: .continuous))
.overlay(RoundedRectangle(cornerRadius: 14, style: .continuous)
- .stroke(Color.continuumOutline, lineWidth: 1))
- .foregroundStyle(Color.continuumOnSurface)
+ .stroke(Color.prairieOutline, lineWidth: 1))
+ .foregroundStyle(Color.prairieOnSurface)
.contentShape(Rectangle())
}
.buttonStyle(.plain)
@@ -101,7 +101,7 @@ to:
.padding(.horizontal, 14)
.padding(.vertical, 8)
.modifier(NowPlayingBarChrome(style: style))
- .foregroundStyle(Color.continuumOnSurface)
+ .foregroundStyle(Color.prairieOnSurface)
.contentShape(Rectangle())
}
.buttonStyle(.plain)
@@ -127,7 +127,7 @@ Then replace the chrome chain. Change:
.clipShape(RoundedRectangle(cornerRadius: 14))
.overlay {
RoundedRectangle(cornerRadius: 14)
- .strokeBorder(Color.continuumOutline, lineWidth: 1)
+ .strokeBorder(Color.prairieOutline, lineWidth: 1)
}
.overlay(alignment: .bottomLeading) {
```
@@ -289,7 +289,7 @@ git commit -m "cast(iOS): NowPlayingShelf + tab-bar accessory attachment"
In `MainTabView.body`, delete the `.safeAreaInset` block that currently carries the two bars. Change:
```swift
- .tint(.continuumOnSurface)
+ .tint(.prairieOnSurface)
#if !os(macOS)
.safeAreaInset(edge: .bottom, spacing: 0) {
#if os(iOS)
@@ -305,7 +305,7 @@ In `MainTabView.body`, delete the `.safeAreaInset` block that currently carries
to:
```swift
- .tint(.continuumOnSurface)
+ .tint(.prairieOnSurface)
#if !os(macOS)
.fullScreenCover(isPresented: Binding(
```
diff --git a/docs/superpowers/specs/2026-06-14-companion-pairing-design.md b/docs/superpowers/specs/2026-06-14-companion-pairing-design.md
index 08933f2ed..c2e97f9e3 100644
--- a/docs/superpowers/specs/2026-06-14-companion-pairing-design.md
+++ b/docs/superpowers/specs/2026-06-14-companion-pairing-design.md
@@ -56,7 +56,7 @@ is still dramatically faster than thumb-typing a URL and password on a remote.
| Role | Platform | Behavior | Reuses |
|------|----------|----------|--------|
| **Receiver** | tvOS | Advertises on the LAN; waiting to be set up | `TVServerSetupView`, `ServerSetupViewModel` (URL normalize), `QRLoginViewModel`, `AppRouter` (auth state), `AppleDeviceIdentity`, `ServerRegistry`, `TokenStore` |
-| **Companion** | iOS | Browses; in-hand; already signed in | `ServerRegistry`, `TokenStore`, `ContinuumAPI`, `HTTPClient` |
+| **Companion** | iOS | Browses; in-hand; already signed in | `ServerRegistry`, `TokenStore`, `PrairieAPI`, `HTTPClient` |
| **Server** | Go | Mints tokens; unchanged in v1 | `/auth/device/{start,poll,approve}`, `GET /auth/device`, `GET /auth/sessions` |
### Server endpoints (already implemented — verified in prairie-server)
@@ -67,7 +67,7 @@ is still dramatically faster than thumb-typing a URL and password on a remote.
- State table `device_login_requests`: `pending → approved → consumed`, `pending → denied`, 10-minute TTL.
### New client method
-`ContinuumAPI.approveDevice(code:)` and `ContinuumAPI.lookupDevice(code:)` — the
+`PrairieAPI.approveDevice(code:)` and `PrairieAPI.lookupDevice(code:)` — the
endpoints exist but approval was previously web-only (`web/src/pages/ActivateDevice.tsx`),
so the iOS client needs these thin wrappers over `HTTPClient`.
@@ -87,7 +87,7 @@ Each unit has one purpose, a defined interface, and is testable in isolation.
discovered TVs (name, deviceId, state, endpoint). Owns Local Network permission
state and foreground/background lifecycle.
- **`CompanionPairingCoordinator`** — phone-side state machine. Connects to the
- chosen TV, runs the per-server loop, calls `ContinuumAPI` / `ServerRegistry` /
+ chosen TV, runs the per-server loop, calls `PrairieAPI` / `ServerRegistry` /
`TokenStore`. Publishes observable state for the UI.
- **UI:**
- `SetUpTVBanner` — auto-appears when a TV in `setup` state is discovered while
@@ -269,7 +269,7 @@ exposure below for v1.
- `PairingSession` framing over an in-memory loopback pair (partial reads,
multiple messages in one buffer, oversized frame rejection).
- `CompanionPairingCoordinator` and `ReceiverPairingCoordinator` state machines
- against a **fake transport** + **fake `ContinuumAPI`**: happy path, multi-server,
+ against a **fake transport** + **fake `PrairieAPI`**: happy path, multi-server,
partial failure, match-code mismatch/decline, token expiry, cancel, code expiry.
Assert **persist-on-success**: no `ServerRegistry` / `TokenStore` mutation until
`signedIn`, and the pending candidate is rolled back on every
diff --git a/docs/superpowers/specs/2026-06-15-ios-aurora-onboarding-design.md b/docs/superpowers/specs/2026-06-15-ios-aurora-onboarding-design.md
index 440c1222d..a3087bcb6 100644
--- a/docs/superpowers/specs/2026-06-15-ios-aurora-onboarding-design.md
+++ b/docs/superpowers/specs/2026-06-15-ios-aurora-onboarding-design.md
@@ -111,7 +111,7 @@ iOS view).
## 6. Screens
-Each screen = backdrop variant + centered `SILO.` wordmark + gold eyebrow + a
+Each screen = backdrop variant + centered `PRAIRIE.` wordmark + gold eyebrow + a
heading block + a liquid-glass form/content card.
### 6.1 Server setup — `ServerSetupView`
@@ -179,7 +179,7 @@ that reveals the protocol segments + port (focus-managed for the remote).
## 9. What stays untouched / out of scope
-- `AuthService`, `ServerRegistry`, `TokenStore`, `ContinuumAPI`, `HTTPClient`.
+- `AuthService`, `ServerRegistry`, `TokenStore`, `PrairieAPI`, `HTTPClient`.
- `AppRouter` auth-state machine and view models (`ServerSetupViewModel`,
`LoginViewModel`, `SignupViewModel`, `ProfileSelectionViewModel`,
`QRLoginViewModel`).
diff --git a/docs/superpowers/specs/2026-06-15-resume-first-home-design.md b/docs/superpowers/specs/2026-06-15-resume-first-home-design.md
index 571b5007c..d04644299 100644
--- a/docs/superpowers/specs/2026-06-15-resume-first-home-design.md
+++ b/docs/superpowers/specs/2026-06-15-resume-first-home-design.md
@@ -73,7 +73,7 @@ direction A (flat background) is the honest fit.
`noFeaturedTopSpacing(...)`) is rendered only in the no-featured branch to keep row 1 from
sliding under the floating header. With the hero permanently gone, this spacer becomes the
**permanent** first element of the stack.
-- **Background:** **flat OLED** (`Color.continuumBackground` / `.continuumBackground()`).
+- **Background:** **flat OLED** (`Color.prairieBackground` / `.prairieBackground()`).
Remove the page-level ambient hero machinery that exists only to back the carousel:
`heroTintBackground`, `heroBackdropImage`, `heroBackdropFadeMask`, `heroTintColor`,
`heroBackdropURL`, `heroBackdropThumbhash`, `computedHeroHeight`,
diff --git a/docs/superpowers/specs/2026-06-15-tvos-detail-redesign-design.md b/docs/superpowers/specs/2026-06-15-tvos-detail-redesign-design.md
index cd06b96b8..27e2372c3 100644
--- a/docs/superpowers/specs/2026-06-15-tvos-detail-redesign-design.md
+++ b/docs/superpowers/specs/2026-06-15-tvos-detail-redesign-design.md
@@ -37,7 +37,7 @@ Conceptual north star: **the detail page is the Skyline focus marquee bloomed to
full screen** — the same backdrop, eyebrow "tick," title, and metadata the
marquee was already previewing expand into an interactive page.
-Reused from `docs/skyline-design-guide.md` and `ContinuumTheme.swift`:
+Reused from `docs/skyline-design-guide.md` and `PrairieTheme.swift`:
- Background OLED black `#000000`; surfaces `#0A0A0A` / elevated `#15171C`.
- Monochrome chrome — primary text `#EDEDED`, secondary @ 60%, tertiary @ 38%,
@@ -48,7 +48,7 @@ Reused from `docs/skyline-design-guide.md` and `ContinuumTheme.swift`:
labels.
- Menus, the selector menus, and the overflow menu use Skyline `glass.strong`
(`#16171B` @ 86% + blur 40).
-- Radii: the squared-control family is **8 pt** (`ContinuumTheme.smallCornerRadius`).
+- Radii: the squared-control family is **8 pt** (`PrairieTheme.smallCornerRadius`).
Cards keep 12 pt; section card backgrounds 18 pt.
## 3. Scope — locked decisions
@@ -218,7 +218,7 @@ in the same family (audiobooks have square cover art, not a 16:9 still):
## 10. Motion
-Reuse `ContinuumTheme` durations: focus 0.12 s, transitions 0.20 s, crossfades
+Reuse `PrairieTheme` durations: focus 0.12 s, transitions 0.20 s, crossfades
0.30 s. Specifics: squared-control focus ring/scale 0.12 s; synopsis expand/
collapse 0.20 s height + fade; selector menu open = `glass.strong` scale
0.96→1.0 + fade. **Reduce Motion:** no scale/expand animation — snap; ring-only
diff --git a/docs/superpowers/specs/2026-06-16-cast-ui-redesign-design.md b/docs/superpowers/specs/2026-06-16-cast-ui-redesign-design.md
index ba839fed1..c9d6c9023 100644
--- a/docs/superpowers/specs/2026-06-16-cast-ui-redesign-design.md
+++ b/docs/superpowers/specs/2026-06-16-cast-ui-redesign-design.md
@@ -48,16 +48,16 @@ From `iosApp/iosApp/Cast/iOS/PrairieCastViews.swift`:
Reuse the existing iOS tokens — do not introduce new colors or a new type scale.
From `iosApp/iosApp/Theme/Colors.swift`:
-- Background OLED black `continuumBackground` `#000000`; elevated surface
- `continuumSurfaceElevated` `#15171C`; glass `continuumGlassStrong`
+- Background OLED black `prairieBackground` `#000000`; elevated surface
+ `prairieSurfaceElevated` `#15171C`; glass `prairieGlassStrong`
(`#16171B` @ 86%).
-- Monochrome chrome — primary `continuumOnSurface` `#EDEDED`, secondary
- `continuumSecondaryText` (`#EDEDED` @ 60%), hairline `continuumOutline`
- (white @ 12%). Active/selected chrome uses `continuumChromeSelectedFill`
- (white @ 14%) / resting `continuumChromeRestingFill` (white @ 7%).
+- Monochrome chrome — primary `prairieOnSurface` `#EDEDED`, secondary
+ `prairieSecondaryText` (`#EDEDED` @ 60%), hairline `prairieOutline`
+ (white @ 12%). Active/selected chrome uses `prairieChromeSelectedFill`
+ (white @ 14%) / resting `prairieChromeRestingFill` (white @ 7%).
- **No chromatic accent.** The play button is a white (`#EDEDED`) filled circle
with a black glyph; artwork is the only place full color lives. Errors use
- `continuumError`.
+ `prairieError`.
Typography uses the system text styles already in the file (`.title2`,
`.headline`, `.subheadline`, `.caption.monospacedDigit()`), not custom fonts.
@@ -85,13 +85,13 @@ background:
1. **Top bar** — leading `chevron.down` (minimize: `hideRemoteControl()` +
`dismiss()`, session stays alive); trailing `•••` overflow menu (see §8).
The TV name moves out of the nav title into the now-playing block.
-2. **Artwork card** — rounded (`continuumSurfaceElevated` placeholder), poster
+2. **Artwork card** — rounded (`prairieSurfaceElevated` placeholder), poster
aspect, rendered with `AsyncImageView(url:thumbhash:contentMode:)`. Modest
max height so the controls always fit without scrolling on small devices.
3. **Title / subtitle** — `state.title` (`.title2`, semibold) and `state.subtitle`
(`.subheadline`, secondary), centered, line-limited (2).
4. **"Playing on {TV}" pill** — `airplayvideo`/`tv` glyph + `activeTarget.name`
- in a subtle `continuumChromeRestingFill` capsule.
+ in a subtle `prairieChromeRestingFill` capsule.
5. **Scrubber** (§6).
6. **Transport row** (§6).
7. **Secondary control row** (§7).
@@ -99,7 +99,7 @@ background:
### Background
A full-bleed `AsyncImageView` of the backdrop (poster fallback), `.blur(radius:)`
-+ a `continuumBackground` scrim at high opacity for legibility, behind the
++ a `prairieBackground` scrim at high opacity for legibility, behind the
foreground stack. This is the single biggest contributor to the native feel.
## 6. Artwork resolution, scrubber & transport
@@ -111,7 +111,7 @@ A small resolver keyed on `state.contentId`:
- Resolves through the **same path the detail screen uses**: check
`ResponseCache.shared` under `CacheKey.itemDetail(contentId)` first (warm and
instant when the user cast from a detail page), otherwise
- `ContinuumAPI.shared.itemDetail(contentId:)`, reading `posterUrl` /
+ `PrairieAPI.shared.itemDetail(contentId:)`, reading `posterUrl` /
`backdropUrl` off the returned `ItemDetail`.
- Holds `posterURL` / `backdropURL` in `@State`; nil `contentId` (idle) → flat
black, no artwork. Failures degrade silently to the flat background.
@@ -165,7 +165,7 @@ as the entry point from Home.
- **Loading / buffering** (`isLoading` / `isBuffering`): spinner replaces the
play/pause glyph; scrubber disabled if `duration <= 0`.
- **Error** (`state.error ?? controller.errorMessage`): compact inline banner on
- `continuumSurfaceElevated` with `continuumError` text, not raw red caption.
+ `prairieSurfaceElevated` with `prairieError` text, not raw red caption.
## 10. Target picker (`PrairieCastTargetPickerView`)
@@ -181,8 +181,8 @@ as the entry point from Home.
## 11. Control-mode button (`PrairieCastControlModeButton`, Home top bar)
Keep the `airplayvideo`-in-a-circle. Replace the ad-hoc `Color.white`/`.clear`
-fills with the chrome tokens (`continuumChromeSelectedFill` /
-`continuumChromeRestingFill`, `continuumOutline` border). Active/connected state
+fills with the chrome tokens (`prairieChromeSelectedFill` /
+`prairieChromeRestingFill`, `prairieOutline` border). Active/connected state
reads clearly (filled + subtle connected indicator). Behavior (menu vs. picker)
is unchanged.
diff --git a/docs/superpowers/specs/2026-08-11-profile-launch-and-tvos-user-mapping-design.md b/docs/superpowers/specs/2026-08-11-profile-launch-and-tvos-user-mapping-design.md
index 570a4aa6f..6781903d3 100644
--- a/docs/superpowers/specs/2026-08-11-profile-launch-and-tvos-user-mapping-design.md
+++ b/docs/superpowers/specs/2026-08-11-profile-launch-and-tvos-user-mapping-design.md
@@ -3,7 +3,7 @@ title: Prairie Profile Launch Choice and Apple TV User Mapping
description: Implementation-ready design for automatic or required profile selection and per-user tvOS profile memory.
date: 2026-08-11
tags:
- - silo
+ - prairie
- apple
- profiles
- design-spec
@@ -13,11 +13,11 @@ tags:
- **Date:** 2026-08-11
- **Status:** Implemented; simulator-validated
-- **Repo:** `silo-apple` (iOS, iPadOS, macOS, tvOS, and the tvOS Top Shelf extension)
+- **Repo:** `prairie-apple` (iOS, iPadOS, macOS, tvOS, and the tvOS Top Shelf extension)
- **Server:** No change required
- **Android:** Parity follow-up recommended; not part of this implementation
-- **Exploration baseline:** `silo-apple` `fdb5225`; `silo-server` `origin/main`
- `2dc7d5e36`; `silo-android` `origin/main` `3efdbd90`
+- **Exploration baseline:** `prairie-apple` `fdb5225`; `prairie-server` `origin/main`
+ `2dc7d5e36`; `prairie-android` `origin/main` `3efdbd90`
## Implementation validation
@@ -374,7 +374,7 @@ picker. Do not automatically select a sibling profile.
### 8.1 Use the modern entitlement model
-Add this entitlement to both the `SiloTV` app and `SiloTVTopShelf` extension targets:
+Add this entitlement to both the `PrairieTV` app and `PrairieTVTopShelf` extension targets:
```xml
com.apple.developer.user-management
@@ -491,7 +491,7 @@ sign-out regression.
### 9.3 Personal-team signing
-Add the User Management key to `SiloTV.personal.entitlements` and
+Add the User Management key to `PrairieTV.personal.entitlements` and
`TopShelf.personal.entitlements` only if personal provisioning supports it. If it does not, keep a
documented local-signing fallback that compiles/runs without system-user separation; production
entitlements remain authoritative. Never replace the paid-team production entitlements to make a
@@ -683,6 +683,6 @@ Use a signed-in physical device; the Simulator does not prove Apple TV user stor
- `iosApp/iosApp/tvOS/Navigation/TVMainTabView.swift` — centralized explicit switch action.
- `iosApp/TopShelf/ContentProvider.swift` / `TopShelfHTTPClient.swift` — policy gating and split
credential reads.
-- `iosApp/SiloTV.entitlements`, `iosApp/TopShelf/TopShelf.entitlements`, and supported personal
+- `iosApp/PrairieTV.entitlements`, `iosApp/TopShelf/TopShelf.entitlements`, and supported personal
variants — User Management capability.
- `iosApp/Tests/` — resolver, migration, identity, Top Shelf, and account-boundary coverage.
diff --git a/docs/tvos-focus.md b/docs/tvos-focus.md
index 2f6f5b1a7..52045bc54 100644
--- a/docs/tvos-focus.md
+++ b/docs/tvos-focus.md
@@ -16,14 +16,35 @@ Use this for ordinary rows, grids, button groups, sheets, and menus where each
actionable item can be a real focus target.
- Render stable `Button`, `NavigationLink`, or `.focusable(true)` items.
-- Group related movement with `.focusSection()` and `.focusScope(...)`.
+ Every actionable element must be reachable by directional movement alone;
+ tvOS has no Tab-key or pointer fallback.
+- Use `.focusSection()` on a container so directional movement can enter it
+ and land on its nearest focusable child, for example a sidebar column that
+ does not line up with the grid beside it.
+- Use `.focusScope(namespace)` together with `prefersDefaultFocus(in:)` and
+ `resetFocus(in:)` to define where default focus lands inside that scope.
+ `focusScope` does not affect directional movement; `focusSection` does.
- Use `@FocusState`, `prefersDefaultFocus`, `defaultFocus`, or `resetFocus` to
seed or restore focus, not to fight the focus engine on every move.
+ `defaultFocus` is evaluated when the view first appears and on automatic
+ focus-state updates, not on user-driven moves, unless you pass
+ `priority: .userInitiated`.
+- Do not move focus programmatically in response to app state unless the
+ focused item disappeared. Apple's Human Interface Guidelines say to avoid
+ changing focus without the user's interaction; the one exception is moving
+ focus to a neighbour when the focused item is removed.
+- Rely on the system focus effect. Use `.focusEffectDisabled()` only when the
+ control draws its own focus appearance, and keep that appearance visually
+ consistent with the platform (scale, lift, highlight).
- Keep the focused subtree mounted and structurally stable while moving focus.
- Attach `onMoveCommand` only at intentional boundaries, such as "Up from the
first card returns to the top menu." Do not intercept normal in-zone movement.
- Move focus geometry with layout (`padding`, `frame`, alignment), not
`.offset`, because tvOS resolves focus from layout frames.
+- Focus can only reach views that are loaded. A `LazyHStack` unloads cards
+ outside its scroll view's bounds, so a row that pins the focused card to its
+ leading edge must extend the scroll view one card past the visible edge
+ (and mask the overflow) or the previous card is unreachable.
Good local examples:
@@ -31,6 +52,7 @@ Good local examples:
- `TVLibraryCollectionsView`
- `TVForYouDropdown`
- `TVProfileDropdown`
+- `TVEpisodeRail` (Series carousel: native cards pinned to the leading edge)
### Composite Focus Control
@@ -38,13 +60,23 @@ Use this when the visual control is one logical selector even though it renders
multiple highlighted rows or columns. A cascading selector is the main example.
- Make one container the real focus target with `.focusable(true)` and a single
- `@FocusState`.
+ `@FocusState`. On tvOS the default `interactions` set already includes
+ `.activate`, so `.focusable(true)` and
+ `.focusable(true, interactions: .activate)` behave the same; use the
+ explicit form only if the view is shared with macOS or iOS.
- Render rows as passive labels; do not make them `Button`s and do not attach
per-row `.focused(...)` bindings.
- Store the highlighted row/column in ordinary `@State`.
- Handle all D-pad movement for the composite with one `onMoveCommand`.
+ The focus engine resolves the move first. If a focusable lies beyond the
+ composite on an axis it owns, even diagonally or off screen, focus can
+ leave before the handler runs, especially on touch-surface swipes, and a
+ swipe can end with a stray orthogonal command. Prefer a native focus graph
+ for anything the focus engine can drive, such as a row of cards.
- Commit the highlighted selection on Select, usually with `onTapGesture` on
- the focused container.
+ the focused container. Use `onExitCommand` for Menu/Back and
+ `onPlayPauseCommand` for Play/Pause. Do not use `onKeyPress` for the Siri
+ Remote; Apple documents it as hardware-keyboard input only.
- Add useful accessibility labels and button/selected traits to the composite
or its rendered labels so VoiceOver still describes the action.
@@ -75,6 +107,42 @@ bar.focusedItem -> Calendar
When this happens, stop adding press interceptors. Decide which focus model the
control should use, then remove the other one.
+## Every Page Needs a Focus Owner
+
+A page that renders no focusable view leaves the focus engine with nothing
+focused. The remote stops responding, and Menu/Back never reaches the shell's
+`onExitCommand` either, because exit commands travel up the *focused* responder
+chain. The page reads as hard-frozen and force quit is the only way out. The
+top bar cannot save it: the shell disables the bar while it hands focus to
+content, so a disabled bar and a placeholder page leave zero focus targets in
+the window.
+
+Empty states, error states, and loading skeletons are the usual offenders —
+they are inert by nature, so it is easy to ship one that is the whole content
+of a page. Apply `tvPageFocusOwner` to any placeholder that can be a page's
+entire content. It makes the placeholder a real focus target, routes Up back to
+the top menu, and seeds itself from the shell's content hand-down token.
+
+`TVFocusWatchdogModifier` is the backstop, not the fix. Its first repair re-arms
+page content, which cannot land on a page with no focus target, so a repeated
+outage at the root escalates to the top menu (`tvFocusRepairAction`).
+
+## Settings Pane Navigation
+
+Settings uses two native focus sections. Right from a category enters its
+first available detail control. Left from any detail row returns to that
+same category, including after scrolling or dismissing a picker. Up/Down
+continues through the controls in the current pane.
+
+Give both pane entry targets `defaultFocus` with `.userInitiated` priority.
+Do not downgrade the rail's selected-category target while the detail pane
+owns focus: doing so lets Left choose a different category by geometry.
+The outer focus scope still chooses the active pane for entry and modal
+restoration. Remember the rail's current control separately from the selected
+category so cancelling Sign Out restores Sign Out, while Left from the details
+still restores the category. Back returns to the category, then exits Settings
+to Home.
+
## Top Menu Ownership
The top menu has three conceptual states:
@@ -98,6 +166,28 @@ When closing a panel, choose the next owner explicitly:
- Selecting a panel row closes, updates route/scope state, and then hands focus
to the destination content.
+## Selecting a Page from the Top Menu
+
+Selecting Home, another tab, or a panel destination enters the page at its
+first row or top control, including when reselecting the current page after
+Menu/Back. Reset the vertical scroll position before forwarding the entry
+focus request. A row feed also resets its first row to the first card.
+
+Use `TVMenuEntryScroll` on the page's scroll view to reveal lazy entry controls
+without animation. Forward focus after scroll geometry reports the top and
+the entry row has had a layout pass. Animating a long scroll while claiming
+focus lets intermediate rows take focus and cancel the entry row's
+restoration ownership. Keep page identity and loaded data stable;
+a menu selection only resets scrolling and entry focus.
+
+If Menu/Back returns ownership to the bar or a panel before the entry request
+finishes, cancel that request. Do not replay it when menu focus clears; the
+next deliberate page selection provides a new request. Cancel on disappearance
+as well, so queued layout callbacks cannot focus a page that has been left.
+
+Returning from a card's detail page still restores the launching card. Ordinary
+Up/Down navigation remains owned by the native focus engine.
+
## Debugging Checklist
When tvOS focus feels random, capture logs for the ownership boundary first:
@@ -130,7 +220,24 @@ Unexpected signs:
## References
-- Apple tvOS focus engine and remote guidance:
- https://developer.apple.com/library/archive/documentation/General/Conceptual/AppleTV_PG/WorkingwiththeAppleTVRemote.html
+- Human Interface Guidelines, Focus and selection (system focus effects, do
+ not move focus without user interaction, every tvOS element must be
+ reachable):
+ https://developer.apple.com/design/human-interface-guidelines/focus-and-selection
+- UIKit, About focus interactions for Apple TV (focus engine rules; only the
+ engine moves focus directionally):
+ https://developer.apple.com/documentation/uikit/about-focus-interactions-for-apple-tv
+- SwiftUI Focus overview (focusable, FocusState, focusScope, focusSection,
+ default focus, resetFocus, focus effects):
+ https://developer.apple.com/documentation/swiftui/focus
- SwiftUI `focusSection()`:
- https://developer.apple.com/documentation/swiftui/view/focussection%28%29
+ https://developer.apple.com/documentation/swiftui/view/focussection()
+- SwiftUI `focusable(_:interactions:)`:
+ https://developer.apple.com/documentation/swiftui/view/focusable(_:interactions:)
+- SwiftUI `defaultFocus(_:_:priority:)`:
+ https://developer.apple.com/documentation/swiftui/view/defaultfocus(_:_:priority:)
+- SwiftUI `onMoveCommand(perform:)`, `onExitCommand(perform:)`,
+ `onPlayPauseCommand(perform:)`:
+ https://developer.apple.com/documentation/swiftui/view/onmovecommand(perform:)
+- Focus Cookbook sample (WWDC23, "The SwiftUI cookbook for focus"):
+ https://developer.apple.com/documentation/swiftui/focus-cookbook-sample
diff --git a/docs/tvos-onboarding/base.css b/docs/tvos-onboarding/base.css
index 421c62a6f..8ddbf96fb 100644
--- a/docs/tvos-onboarding/base.css
+++ b/docs/tvos-onboarding/base.css
@@ -1,5 +1,5 @@
/* ============================================================================
- Silo tvOS — First-Run Redesign Mockups
+ Prairie tvOS — First-Run Redesign Mockups
base.css — shared design tokens (Skyline), component kit, 1920×1080 scaler
Tokens sourced from docs/skyline-design-guide.md + iosApp/.../Theme/*.swift
(1 tvOS pt = 1 px on the 1920×1080 canvas)
@@ -38,7 +38,7 @@
--field-fill: #15171c;
--field-border: rgba(255, 255, 255, 0.22);
- /* Radii (ContinuumTheme.swift) */
+ /* Radii (PrairieTheme.swift) */
--r-card: 12px;
--r-small: 8px;
--r-container: 18px;
diff --git a/docs/tvos-onboarding/base.js b/docs/tvos-onboarding/base.js
index 71dd1889c..7d9703b18 100644
--- a/docs/tvos-onboarding/base.js
+++ b/docs/tvos-onboarding/base.js
@@ -33,7 +33,7 @@
}
function renderQR(el) {
var n = 25; // modules
- var rnd = seeded(el.getAttribute("data-qr") || "silo");
+ var rnd = seeded(el.getAttribute("data-qr") || "prairie");
var cells = "";
function reserved(r, c) {
return (r < 8 && c < 8) || (r < 8 && c > n - 9) || (r > n - 9 && c < 8);
diff --git a/docs/tvos-onboarding/index.html b/docs/tvos-onboarding/index.html
index 206666b54..c521811a3 100644
--- a/docs/tvos-onboarding/index.html
+++ b/docs/tvos-onboarding/index.html
@@ -99,7 +99,7 @@ Three takes on the same flow
Each renders all five screens end-to-end. All are fully dark (TV research strongly favors it) and reuse your Skyline color/spacing/motion tokens — they differ in mood, surface, and how loudly the phone-handoff idea is expressed.
+ 
+ 