How janeeva1/pixel-perfect-copy works
Pixel Perfect Copy is an institutional attendance-management app: users sign in, manage student and staff records, and use attendance sessions to turn biometric exports into present/absent registers. The sampled people route shows spreadsheet parsing, record normalization, and Supabase persistence; the README documents session-based register generation, but the dashboard implementation was not excerpted, so its internal steps are not inferred. The map also includes authentication, routing, preview-session storage, and error handling. Some route and dashboard links rely on the SOURCE INDEX rather than full excerpts.
Main entry points: client.ts Supabase client · routeTree.gen.ts Route graph · auth.tsx Sign-in page · people.tsx People management
Components 20
App experience
- Landing page
src/routes/index.tsx - Router setup
src/router.tsx - Route graph
src/routeTree.gen.ts - Root route
src/routes/__root.tsx - App shell
src/components/AppShell.tsx - UI controls
src/components/ui/button.tsx
People and attendance
- Attendance dashboard
src/routes/_authenticated/dashboard.tsx - People management
src/routes/_authenticated/people.tsx - Spreadsheet reader
src/lib/spreadsheet.ts - Attendance utilities
src/lib/attendance.ts
Identity and data
- Sign-in page
src/routes/auth.tsx - Authenticated layout
src/routes/_authenticated/route.tsx - Session and roles
src/lib/useAuth.ts - Supabase client
src/integrations/supabase/client.ts - Preview auth storage
src/integrations/supabase/previewAuthStorage.ts - Supabase service
- Lovable OAuth adapter
src/integrations/lovable/index.ts
Runtime support
- Error capture
src/lib/error-capture.ts - Error page
src/lib/error-page.ts
Other components
- Institution user
Connections 31
- Institution user → Landing page: opens
src/routes/index.tsx - Landing page → Sign-in page: routes unauthenticated
src/routes/index.tsx - Landing page → Attendance dashboard: routes signed-in
src/routes/index.tsx - Institution user → Sign-in page: signs in or up
src/routes/auth.tsx - Sign-in page → Supabase client: authenticates with
src/routes/auth.tsx - Sign-in page → Lovable OAuth adapter: starts Google OAuth
src/routes/auth.tsx - Router setup → Route graph: uses routes
src/router.tsx - Route graph → Root route: registers route
src/routeTree.gen.ts - Route graph → Landing page: registers route
src/routeTree.gen.ts - Route graph → Sign-in page: registers route
src/routeTree.gen.ts - Route graph → Authenticated layout: registers route
src/routeTree.gen.ts - Route graph → Attendance dashboard: registers route
src/routeTree.gen.ts - Route graph → People management: registers route
src/routeTree.gen.ts - Authenticated layout → Supabase client: checks user
src/routes/_authenticated/route.tsx - Authenticated layout → Sign-in page: redirects unauthenticated
src/routes/_authenticated/route.tsx - Authenticated layout → App shell: wraps authenticated pages
src/routes/_authenticated/route.tsx - App shell → Session and roles: reads session
src/components/AppShell.tsx - Attendance dashboard → Supabase client: queries attendance data
src/routes/_authenticated/dashboard.tsx - Attendance dashboard → Session and roles: checks session
src/routes/_authenticated/dashboard.tsx - People management → Supabase client: reads and saves records
src/routes/_authenticated/people.tsx - People management → Spreadsheet reader: reads uploaded file
src/routes/_authenticated/people.tsx - People management → Attendance utilities: normalizes records
src/routes/_authenticated/people.tsx - People management → Session and roles: checks permissions
src/routes/_authenticated/people.tsx - Session and roles → Supabase client: loads session and roles
src/lib/useAuth.ts - Supabase client → Preview auth storage: configures auth storage
src/integrations/supabase/client.ts - Supabase client → Supabase service: connects to
src/integrations/supabase/client.ts - Supabase client → Preview auth storage: falls back to local storage
src/integrations/supabase/previewAuthStorage.ts - Root route → Error page: uses error handling
src/routes/__root.tsx - Error page → Error capture: reports errors
src/lib/error-page.ts - Landing page → UI controls: renders buttons
src/routes/index.tsx - Sign-in page → UI controls: renders buttons
src/routes/auth.tsx