How angelperezcastro/locilandapp works
LociLand is a child-focused memory-palace learning app. A learner signs in, creates a themed palace, adds and orders memory stations, then walks the route in guided review and earns progress rewards. The graph highlights palace authoring, review, and gamification alongside navigation and Firebase-backed data. README capabilities fill out some branches; sampled source most clearly confirms palace-store calls and review completion wiring, so uncertain screen-to-service links are omitted.
Main entry points: AppNavigator.tsx Learning navigation · usePalaceStore.ts Palace state · reviewService.ts Review sessions · ProgressScreen.tsx Progress dashboard
Components 30
App experience
- App entry
App.tsx - Root navigation
src/navigation/RootNavigator.tsx - Sign-in flow
src/navigation/AuthNavigator.tsx - Learning navigation
src/navigation/AppNavigator.tsx - Onboarding
src/screens/onboarding/Onboarding01Screen.tsx - Login and register
src/screens/auth/LoginScreen.tsx
Palace authoring
- Palace home
src/screens/app/HomeScreen.tsx - Create palace
src/screens/app/CreatePalaceScreen.tsx - Palace route
src/screens/app/PalaceDetailScreen.tsx - Station editing
src/screens/app/AddStationScreen.tsx - Palace state
src/store/usePalaceStore.ts - Palace operations
src/services/palaceService.ts - Station operations
src/services/stationService.ts
Guided learning
- Guided review
src/screens/app/ReviewScreen.tsx - Review preparation
src/services/reviewScreenDataService.ts - Review sessions
src/services/reviewService.ts
Progress and rewards
- Progress dashboard
src/screens/app/ProgressScreen.tsx - Achievements
src/services/achievementService.ts - XP and levels
src/services/xpService.ts - Streak tracking
src/services/streakService.ts - Reminder logic
src/services/notificationService.ts
Cloud and identity
- Authentication
src/services/auth.ts - User profile
src/services/userProfile.ts - Firebase client
src/services/firebase.ts - Firebase cloud data
- Firebase image storage
- Station image transfer
src/services/storageService.ts - Device onboarding state
src/services/onboardingStorage.ts
Other components
- Child learner
- Device notifications
Connections 35
- Child learner → App entry: opens
- App entry → Root navigation: mounts
- Root navigation → Sign-in flow: routes unauthenticated
- Root navigation → Learning navigation: routes authenticated
- Sign-in flow → Login and register: presents
- Learning navigation → Palace home: routes to
- Learning navigation → Create palace: routes to
- Learning navigation → Palace route: routes to
- Learning navigation → Station editing: routes to
- Learning navigation → Guided review: routes to
- Learning navigation → Progress dashboard: routes to
- Create palace → Palace state: creates palace
- Palace home → Palace state: loads palaces
- Palace route → Palace state: loads route
- Station editing → Palace state: edits stations
- Palace state → Palace operations: manages palaces
- Palace state → Station operations: manages stations
- Guided review → Review sessions: completes session
- Review sessions → Achievements: checks unlocks
- Review sessions → XP and levels: awards XP
- Review sessions → Firebase cloud data: reads and writes
- Review preparation → Firebase cloud data: loads palace route
- Palace operations → Firebase cloud data: reads and writes
- Station operations → Firebase cloud data: reads and writes
- Station operations → Station image transfer: transfers images
- Station image transfer → Firebase image storage: uploads and deletes
- Progress dashboard → Achievements: shows rewards
- Progress dashboard → Streak tracking: shows streak
- Progress dashboard → XP and levels: shows XP
- Reminder logic → Device notifications: schedules reminders
- Authentication → Firebase client: uses client
- User profile → Firebase cloud data: reads and writes
- Firebase client → Firebase cloud data: connects
- Firebase client → Firebase image storage: connects
- Onboarding → Device onboarding state: persists completion