How pman369/stateos works
StateOS is a React Native human-capability app centered on a short path from launch or recommendation to a guided somatic protocol, session execution, and reflection. Its broader documented capabilities include capability-state views, insights, journaling, identity/profile, settings, and a guarded AI coach. The graph shows sampled navigation, protocol, session, and coach relationships; other screens are preserved as navigation destinations. The README describes telemetry, privacy, and product behavior, but the sampled source does not establish their runtime data flows or external integrations.
Main entry points: RootNavigator.tsx Root Navigation · AICoachScreen.tsx AI Coach · ProtocolPlayerScreen.tsx Protocol Player · ProtocolsScreen.tsx Protocol Library
Components 21
App Shell
- App Entry
App.tsx - Root Navigation
src/navigation/RootNavigator.tsx
User Experiences
Protocol Execution
- Protocol Library
src/screens/ProtocolsScreen.tsx - Protocol Definitions
src/data/protocols.ts - Protocol Player
src/screens/ProtocolPlayerScreen.tsx - Session FSM
src/store/sessionStore.ts
Domain and Data
- Capability Domains
src/data/capabilities.ts - Coach Guardrails
src/services/aiCoach.ts - Validation Schemas
src/schemas/index.ts - Domain Types
src/types/index.ts - SQLite Client
src/db/client.ts - Local Database Schema
src/db/schema.ts - Design Tokens
src/constants/tokens.ts
Other components
- User
Connections 22
- User → App Entry: opens
README.md - App Entry → Root Navigation: renders
App.tsx - Root Navigation → Home: routes to
src/navigation/RootNavigator.tsx - Root Navigation → Capability State: routes to
src/navigation/RootNavigator.tsx - Root Navigation → Protocol Library: routes to
src/navigation/RootNavigator.tsx - Root Navigation → Journal: routes to
src/navigation/RootNavigator.tsx - Root Navigation → Insights: routes to
src/navigation/RootNavigator.tsx - Root Navigation → AI Coach: routes to
src/navigation/RootNavigator.tsx - Root Navigation → Profile: routes to
src/navigation/RootNavigator.tsx - Root Navigation → Settings: routes to
src/navigation/RootNavigator.tsx - Root Navigation → Protocol Player: registers modal
src/navigation/RootNavigator.tsx - Protocol Library → Protocol Definitions: lists protocols
src/screens/ProtocolsScreen.tsx - Protocol Library → Protocol Player: launches protocol
README.md - Protocol Player → Session FSM: updates session
src/screens/ProtocolPlayerScreen.tsx - Capability State → Capability Domains: reads domains
src/screens/StateScreen.tsx - AI Coach → Coach Guardrails: requests response
src/screens/AICoachScreen.tsx - Coach Guardrails → Validation Schemas: validates response
src/services/aiCoach.ts - AI Coach → Protocol Definitions: resolves recommendation
src/screens/AICoachScreen.tsx - AI Coach → Protocol Player: launches recommendation
src/screens/AICoachScreen.tsx - Session FSM → Domain Types: uses transitions
src/store/sessionStore.ts - Validation Schemas → Domain Types: checks transition rules
src/schemas/index.ts - SQLite Client → Local Database Schema: initializes database
src/db/client.ts