How oceanosdev/spacetraders-ui works
SpaceTraders Fleet Console is an authenticated dashboard for viewing an agent and operating its fleet, markets, and contracts. The principal flow is token entry, agent loading, then navigating to domain consoles for ship management, trading, or contract delivery tracking. The sampled code confirms authentication, agent and waypoint requests, and market-waypoint selection; feature API details and page wiring are not sampled, so those connections are left out.
Main entry points: App.tsx App dashboard · AppContent.tsx Console navigation · ShipsPage.tsx Ship console · ContractsPage.tsx Contracts console
Components 21
Access and shell
- App dashboard
src/App.tsx - Auth gate
src/features/auth/components/AuthGate.tsx - Token entry
src/features/auth/components/TokenForm.tsx - Token state
src/features/auth/authSlice.ts - Console navigation
src/features/navigation/components/AppContent.tsx - API client
src/services/spacetradersApi.ts
Fleet operations
- Ship console
src/features/ships/ShipsPage.tsx - Ship operations API
src/features/ships/api/shipsApi.ts - Ship actions
src/features/ships/components/ship-actions/ShipActionsPanel.tsx - Ship navigation
src/features/ships/components/ship-navigation/ShipNavigationPanel.tsx
Market operations
- Markets console
src/features/markets/MarketsPage.tsx - Market operations API
src/features/markets/api/marketsApi.ts - Market selection
src/features/markets/hooks/useMarketsPageState.ts - Market waypoints
src/features/markets/hooks/useSystemMarketWaypoints.ts - Waypoint lookup
src/features/systems/hooks/useSystemWaypoints.ts
Contract operations
- Contracts console
src/features/contracts/ContractsPage.tsx - Contract operations API
src/features/contracts/api/contractsApi.ts - Delivery tracking
src/features/contracts/model/contractDelivery.ts - Deadline countdown
src/utils/countdown.ts
Other components
- Console user
- SpaceTraders API
Connections 22
- Console user → App dashboard: opens console
- App dashboard → Auth gate: checks access
- Auth gate → Token state: reads token
- Auth gate → Token entry: requests token
- Token entry → Token state: sets token
- App dashboard → API client: loads agent
- API client → Token state: reads token
- API client → SpaceTraders API: requests data
- App dashboard → Console navigation: shows consoles
- Console navigation → Ship console: opens console
- Console navigation → Markets console: opens console
- Console navigation → Contracts console: opens console
- Market waypoints → Waypoint lookup: filters waypoints
- Waypoint lookup → API client: fetches pages
- Markets console → Market selection: selects market
- Market selection → Market operations API: uses market actions
- Ship console → Ship operations API: uses ship actions
- Ship console → Ship actions: offers operations
- Ship console → Ship navigation: offers navigation
- Contracts console → Contract operations API: uses contract actions
- Contracts console → Delivery tracking: tracks progress
- Contracts console → Deadline countdown: shows deadlines