Ski Spot
Architecture Blueprint

Component Tree

Every UI component, its props, and parent-child relationships.

App
├── NavigationContainer
│   └── BottomTabs
│       ├── FindScreen
│       │   ├── DeviceSelector        props: { devices, selected, onSelect }
│       │   ├── ScanButton            props: { phase, onStart, onStop }
│       │   ├── RSSIPolarChart        props: { bins, currentHeading }
│       │   ├── DirectionArrow        props: { bearing, compassHeading }
│       │   ├── SignalStrengthBar     props: { rssi, min, max }
│       │   ├── CoverageArc           props: { coverage, threshold }
│       │   └── ScanInstructions      props: { phase }
│       ├── DevicesScreen
│       │   ├── DeviceCard[]          props: { device, onRename, onRemove }
│       │   ├── AddDeviceButton       props: { onPress }
│       │   └── ScanModal             props: { visible, found[], onSelect }
│       └── SettingsScreen
│           ├── FirmwareInfo          props: { version }
│           └── ResetButton           props: { onReset }

Zustand State Schemas

Two stores: scan state (ephemeral) and device state (persisted).

// ─── scanStore.ts ───
interface ScanStore {
  // State
  phase: ScanPhase;
  targetDeviceId: string | null;
  samples: RSSISample[];
  currentHeading: number;
  currentRSSI: number | null;
  result: ScanResult | null;
  error: string | null;

  // Actions
  startScan: (deviceId: string) => void;
  stopScan: () => void;
  addSample: (sample: RSSISample) => void;
  updateHeading: (heading: number) => void;
  updateRSSI: (rssi: number) => void;
  reset: () => void;
}

// ─── deviceStore.ts ───
interface DeviceStore {
  // State (persisted to AsyncStorage)
  pairedDevices: PairedDevice[];
  selectedDeviceId: string | null;

  // Actions
  addDevice: (device: PairedDevice) => void;
  removeDevice: (id: string) => void;
  renameDevice: (id: string, name: string) => void;
  selectDevice: (id: string) => void;
  updateLastSeen: (id: string, rssi: number) => void;
  resetAll: () => void;
}

Data Flow

How data moves through the system during a scan cycle.

Platform Permissions Matrix

Required permissions and platform-specific behaviour.