How ystem-lms/mobile works
This is an Expo mobile foundation for a STEM-and-chess learning app. Its current user workflow is startup configuration and session bootstrap, mock student or mentor sign-in, then role-gated navigation into the app; the home screen links to learning, puzzles, play, and profile. Those feature screens are present, but real authentication, lessons, gameplay, and backend integration remain pending. The graph reflects documented capabilities and route structure; unsampled route implementations are not assumed to contain working domain logic.
Main entry points: SessionProvider.tsx Session provider · _layout.tsx Root navigator · index.tsx Home screen · AppText.tsx Text component
Components 26
App navigation
- Root navigator
app/_layout.tsx - Sign-in screen
app/(public)/sign-in.tsx - App tabs
app/(app)/(tabs)/_layout.tsx - Home screen
app/(app)/(tabs)/index.tsx - Profile screen
app/(app)/(tabs)/profile.tsx - Mentor screen
app/(app)/mentor/index.tsx
Learning and play
- Learn screen
app/(app)/(tabs)/learn.tsx - Lesson details
app/(app)/lesson-detail.tsx - Play screen
app/(app)/(tabs)/play.tsx - Game screen
app/(app)/play-game.tsx - Puzzle screen
app/(app)/puzzles.tsx
Session and UI foundation
- Session provider
src/providers/SessionProvider.tsx - Session reducer
src/state/session.ts - Query provider
src/providers/QueryProvider.tsx - Environment validation
src/config/env.ts - Placeholder screens
src/components/PlaceholderScreen.tsx - Session placeholder
src/components/SessionPlaceholderScreen.tsx - Text component
src/components/ui/AppText.tsx - Screen component
src/components/ui/Screen.tsx - Loading spinner
src/components/ui/Spinner.tsx - Button component
src/components/ui/Button.tsx - Feedback components
src/components/feedback/ConnectionBanner.tsx - Inline error
src/components/feedback/InlineError.tsx - Semantic theme
src/design/theme.ts - Design tokens
src/design/tokens.ts
Other components
- Mobile user
Connections 29
- Mobile user → Sign-in screen: opens app
README.md - Sign-in screen → Session provider: mock sign-in
app/(public)/sign-in.tsx - Root navigator → Environment validation: validates config
app/_layout.tsx - Root navigator → Query provider: wraps app
app/_layout.tsx - Root navigator → Session provider: provides session
app/_layout.tsx - Root navigator → Session provider: routes by status
app/_layout.tsx - Session provider → Session reducer: reduces actions
src/providers/SessionProvider.tsx - Root navigator → Screen component: renders bootstrap
app/_layout.tsx - Root navigator → Loading spinner: shows loading
app/_layout.tsx - Session provider → App tabs: enables app routes
- Session provider → Sign-in screen: enables public routes
app/(public)/sign-in.tsx - App tabs → Home screen: hosts route
app/(app)/(tabs)/_layout.tsx - Home screen → Learn screen: links to learning
app/(app)/(tabs)/index.tsx - Home screen → Puzzle screen: links to puzzles
app/(app)/(tabs)/index.tsx - Home screen → Play screen: links to play
app/(app)/(tabs)/index.tsx - Home screen → Profile screen: links to profile
app/(app)/(tabs)/index.tsx - Profile screen → Session provider: uses session
app/(app)/(tabs)/profile.tsx - Mentor screen → Session placeholder: renders placeholder
app/(app)/mentor/index.tsx - Session placeholder → Session provider: reads session
src/components/SessionPlaceholderScreen.tsx - Session placeholder → Placeholder screens: renders
src/components/SessionPlaceholderScreen.tsx - Placeholder screens → Text component: renders text
src/components/PlaceholderScreen.tsx - Placeholder screens → Screen component: uses layout
src/components/PlaceholderScreen.tsx - Text component → Semantic theme: styles text
src/components/ui/AppText.tsx - Semantic theme → Design tokens: uses tokens
src/design/theme.ts - Root navigator → Semantic theme: styles tabs
- Button component → Text component: renders label
src/components/ui/Button.tsx - Button component → Loading spinner: renders loading
src/components/ui/Button.tsx - Feedback components → Text component: renders message
src/components/feedback/ConnectionBanner.tsx - Inline error → Text component: renders message
src/components/feedback/InlineError.tsx