How doosemavis/astro-clock works
Astro App provides living astrological charts across web and mobile: users enter birth details, view fixed natal and moving planetary positions, and explore other times or chart comparisons. The shared engine computes chart data; the mobile app also provides onboarding, accounts, themes, exports, and purchases. Web adds account and Stripe subscription routes, while a RevenueCat webhook maps purchase events to subscription rows. The README documents the web MVP and engine; mobile relationships below are limited to indexed imports and excerpted calls.
Main entry points: App.tsx Mobile app shell · chart.ts Chart calculations · BirthForm.tsx Birth form · LoginScreen.tsx Mobile login
Components 23
Birth and onboarding
- Birth form
apps/mobile/components/BirthForm.tsx - Birth data helpers
apps/mobile/lib/birthValidation.ts - Place lookup
apps/mobile/lib/geocode.ts
Chart experience
- Mobile app shell
apps/mobile/App.tsx - Chart time control
apps/mobile/hooks/useChartClock.ts - Chart controls
apps/mobile/components/chart/ChartControls.tsx - Chart wheel
apps/mobile/components/chart/ChartWheel.tsx - Chart comparison
apps/mobile/components/chart/CompareView.tsx - Sky backdrop
apps/mobile/components/chart/Sky.tsx - Coordinate readings
apps/mobile/components/coordinates/CoordinatesPanel.tsx - Chart export
apps/mobile/components/export/ExportCard.tsx
Astrology and readings
- Chart calculations
packages/engine/src/chart.ts - Planet positions
packages/engine/src/ephemeris.ts - Planet aspects
packages/engine/src/aspects.ts - Interpretations
packages/interpretations/src/assemble.ts
Accounts and access
- Mobile authentication
apps/mobile/lib/auth.tsx - Mobile login
apps/mobile/components/auth/LoginScreen.tsx
Persistence and billing
- Subscription routes
apps/web/app/api/stripe/checkout/route.ts - Stripe
- RevenueCat webhook
supabase/functions/revenuecat-webhook/index.ts - Subscription event mapper
supabase/functions/_shared/rcEventToRow.ts - Supabase data
apps/web/lib/supabase/server.ts
Other components
- Chart user
Connections 23
- Chart user → Mobile app shell: opens
- Mobile app shell → Birth form: opens form
apps/mobile/App.tsx - Birth form → Place lookup: searches places
apps/mobile/components/BirthForm.tsx - Birth form → Mobile app shell: submits details
apps/mobile/App.tsx - Mobile app shell → Chart time control: sets chart time
apps/mobile/App.tsx - Mobile app shell → Chart controls: shows controls
apps/mobile/App.tsx - Mobile app shell → Chart wheel: renders chart
apps/mobile/App.tsx - Mobile app shell → Chart comparison: renders comparison
apps/mobile/App.tsx - Mobile app shell → Sky backdrop: renders backdrop
apps/mobile/App.tsx - Mobile app shell → Coordinate readings: opens readings
apps/mobile/App.tsx - Mobile app shell → Chart export: exports chart
apps/mobile/App.tsx - Chart time control → Chart calculations: resolves positions
- Chart wheel → Chart calculations: displays chart data
- Chart calculations → Planet positions: uses positions
- Chart calculations → Planet aspects: computes aspects
- Chart calculations → Interpretations: supplies chart data
- Chart user → Mobile login: requests account
- Mobile app shell → Mobile login: opens sign-in
apps/mobile/App.tsx - Mobile login → Mobile authentication: authenticates
apps/mobile/components/auth/LoginScreen.tsx - Chart user → Subscription routes: manages plan
- Subscription routes → Stripe: creates checkout
- RevenueCat webhook → Subscription event mapper: maps event
supabase/functions/revenuecat-webhook/index.ts - Subscription event mapper → Supabase data: writes subscription