How angelrangel21/rangel-guitar works
Rangel Guitar is a multilingual guitar-song library and learning app. Visitors search or browse songs and artists, then view lyrics and chords; the README also documents transposition, favorites, song requests, authentication, and admin review. Learning tools provide separate practice features. The graph uses sampled search and auth code plus SOURCE INDEX references for supported internal links; README-described capabilities are retained, but unsampled route-to-service wiring is not inferred.
Main entry points: supabase.ts Supabase · home-client.tsx Home browser · page.tsx Learning hub · auth.stores.ts Auth and favorites state
Components 33
Song library
- Song home
src/app/[locale]/page.tsx - Home browser
src/components/home-client.tsx - Song list
src/components/song-list.tsx - Search UI
src/components/searching/search.tsx - Search state
src/components/searching/useSearch.ts - Song search
src/components/searching/search.service.ts - Search page
src/app/[locale]/search/page.tsx - Search results view
src/components/searching/search-page-content.tsx - Artist pages
src/app/[locale]/artists/page.tsx - Song view
src/app/[locale]/songs/[slug]/page.tsx - Song catalog
src/services/song.service.ts
Music learning
- Learning hub
src/app/[locale]/learn/page.tsx - Chord library
src/app/[locale]/chords/page.tsx - Scale explorer
src/app/[locale]/scales/page.tsx - Circle of fifths
src/app/[locale]/learn/circle-of-fifths/page.tsx - Ear trainer
src/app/[locale]/learn/ear-trainer/page.tsx - Metronome
src/app/[locale]/learn/metronome/page.tsx
Identity and favorites
- Login and registration
src/app/[locale]/login/page.tsx - Auth provider
src/auth/provider/auth.provider.tsx - Auth and favorites state
src/auth/stores/auth.stores.ts - Auth service
src/auth/service/auth.service.ts - User profiles
src/auth/service/user.service.ts - Favorites page
src/app/[locale]/favorites/page.tsx - Favorite persistence
src/services/favorites.service.ts
Content operations
- Song request
src/app/[locale]/request-song/page.tsx - Request handling
src/services/requests-service.ts - Admin request review
src/app/[locale]/admin/requests/page.tsx - Song and artist management
src/app/[locale]/admin/add-song/page.tsx
Shared platform
- Supabase
src/lib/supabase.ts - Server Supabase client
src/lib/supabase/server.ts - Database schema types
src/types/database.types.ts
Other components
- Visitor
- Supabase Auth
Connections 35
- Visitor → Song home: browses
README.md - Song home → Home browser: renders
src/app/[locale]/page.tsx - Home browser → Song list: renders
src/components/home-client.tsx - Home browser → Search UI: renders
src/components/home-client.tsx - Home browser → Search page: routes query
src/components/home-client.tsx - Search page → Search results view: renders
src/app/[locale]/search/page.tsx - Search results view → Search UI: renders
src/components/searching/search-page-content.tsx - Search UI → Search state: uses state
src/components/searching/search.tsx - Search state → Song search: searches
src/components/searching/useSearch.ts - Song search → Supabase: queries
src/components/searching/search.service.ts - Song home → Song catalog: loads songs
src/app/[locale]/page.tsx - Visitor → Artist pages: browses artists
README.md - Visitor → Song view: views songs
README.md - Visitor → Learning hub: opens learning
README.md - Learning hub → Circle of fifths: offers tool
README.md - Learning hub → Ear trainer: offers tool
README.md - Learning hub → Metronome: offers tool
README.md - Visitor → Chord library: explores chords
README.md - Visitor → Scale explorer: explores scales
README.md - Visitor → Login and registration: registers or signs in
README.md - Auth provider → Auth and favorites state: updates state
src/auth/provider/auth.provider.tsx - Auth and favorites state → Auth service: authenticates
src/auth/stores/auth.stores.ts - Auth service → Supabase: uses auth API
src/auth/service/auth.service.ts - Supabase Auth → Auth service: provides auth
README.md - Auth and favorites state → User profiles: loads profile
src/auth/stores/auth.stores.ts - Auth and favorites state → Favorite persistence: updates favorites
src/auth/stores/auth.stores.ts - Favorite persistence → Supabase: persists favorites
src/services/favorites.service.ts - Visitor → Favorites page: opens favorites
README.md - Visitor → Song request: requests song
README.md - Visitor → Admin request review: admin reviews
README.md - Visitor → Song and artist management: admin manages catalog
README.md - Song catalog → Supabase: queries catalog
src/services/song.service.ts - Request handling → Server Supabase client: uses server client
src/services/requests-service.ts - Supabase → Database schema types: uses schema types
src/lib/supabase.ts - Server Supabase client → Supabase Auth: connects server auth