How h3llynx/rollerscape works
RollerScape is a community map for inline skaters to discover, contribute, review, and navigate skating spots. The main journey runs from public map browsing and filtering to selecting a spot and viewing its details or route; signed-in users can submit spots and manage favorites, reviews, and skating profiles. The map, auth, profile, and spot-management stages are represented alongside Supabase-backed services and external map/location capabilities. Arrows are limited to relationships shown in excerpts or explicitly documented; some capability links remain unverified because their page implementations were not sampled.
Main entry points: MapPage.tsx Map Discovery · router.tsx Route Configuration · ProtectedRoute.tsx Protected Routes · AddSpotPage.tsx Spot Submission
Components 27
Application
- App Providers
src/App.tsx - Route Configuration
src/router/router.tsx - Protected Routes
src/router/ProtectedRoute.tsx
Map Discovery
- Map Discovery
src/features/map/MapPage.tsx - Map Context Hooks
src/features/map/hooks/useContexts.tsx - Location Search
src/features/map/components/LocationSearch/LocationSearch.tsx - Map & Routes
src/features/map/components/MapBase/MapBase.tsx - Spot Details
src/features/spot_management/components/SpotLeftPanel/SpotLeftPanel.tsx
Spot Contributions
- Spot Submission
src/features/spot_management/AddSpotPage.tsx - Spot Form State
src/features/spot_management/hooks/useSpotForm.tsx - Spot Map Input
src/features/spot_management/hooks/useAddSpotMap.tsx - Reviews
src/features/spot_management/components/ReviewForm/ReviewForm.tsx
Accounts & Profiles
- Sign In / Register
src/features/auth/AuthPage.tsx - Auth Session
src/features/auth/context/AuthProvider.tsx - User Profile
src/features/profile/ProfilePage.tsx - Skater Onboarding
src/features/profile/OnboardingPage.tsx
Services & Data
- Auth Operations
src/services/auth.ts - Supabase Client
src/utils/supabase.ts - Spot Data Services
src/services/spots.ts - Location Services
src/services/geolocation.ts - Photo Hosting
src/services/image-hosting.ts - Data Operations
src/services/data.ts - Supabase Database
- OSRM Routing
- Nominatim Search
- Browser Geolocation
Other components
- Skater
Connections 32
- Skater → Route Configuration: opens
src/router/router.tsx - Route Configuration → Map Discovery: routes to
src/router/router.tsx - Route Configuration → Sign In / Register: routes to
src/router/router.tsx - Route Configuration → Protected Routes: wraps
src/router/router.tsx - Protected Routes → User Profile: allows
src/router/router.tsx - Protected Routes → Spot Submission: allows
src/router/router.tsx - Protected Routes → Skater Onboarding: allows
src/router/router.tsx - App Providers → Route Configuration: provides
src/App.tsx - App Providers → Auth Session: provides
src/App.tsx - Sign In / Register → Auth Operations: calls
src/features/auth/AuthPage.tsx - Auth Session → Auth Operations: calls
src/features/auth/context/AuthProvider.tsx - Auth Operations → Supabase Client: uses
src/services/auth.ts - Supabase Client → Supabase Database: connects
src/utils/supabase.ts - Map Discovery → Map Context Hooks: reads context
src/features/map/MapPage.tsx - Map Discovery → Map & Routes: renders
src/features/map/MapPage.tsx - Map Discovery → Spot Details: renders
src/features/map/MapPage.tsx - Map Discovery → Location Search
src/features/map/MapPage.tsx - Map Discovery → Spot Data Services
- Spot Data Services → Supabase Client: uses
src/services/spots.ts - Location Search → Nominatim Search: searches
- Map & Routes → OSRM Routing: previews routes
- Map Discovery → Location Services: requests position
- Location Services → Browser Geolocation: uses
- Spot Submission → Spot Form State: uses form
- Spot Submission → Spot Map Input: uses map input
- Spot Form State → Photo Hosting: uploads photos
src/features/spot_management/hooks/useSpotForm.tsx - User Profile → Data Operations: loads profile data
- Reviews → Data Operations: calls
src/features/spot_management/components/ReviewForm/ReviewForm.tsx - Data Operations → Supabase Client: uses
src/services/data.ts - Data Operations → Supabase Database: reads and writes
- Skater → User Profile: views
- Skater → Spot Submission: submits