How alcalino100/dashboard-meta-ads works
This is a multi-account Meta Ads management dashboard. Users sign in, enter a dashboard with account and date filters, and view Meta account performance and campaign hierarchy; separate management screens support clients, connections, settings, and users. The runtime divides into UI, Meta data access, and Supabase-backed administration. Several screens and routes are represented from the file tree and SOURCE INDEX rather than inspected source, so their internal links are omitted where evidence is unavailable.
Main entry points: dashboard-shell.tsx Dashboard shell · admin.ts Server Supabase client · page.tsx App entry · meta-api.ts Meta Graph integration
Components 26
Dashboard experience
- App entry
app/page.tsx - Sign-in screens
components/auth/auth-screens.tsx - Dashboard shell
components/dashboard/dashboard-shell.tsx - Account and date filters
lib/filters-context.tsx - Performance overview
components/dashboard/overview-section.tsx - Campaign hierarchy
components/dashboard/hierarchy-section.tsx - Creative reporting
components/dashboard/creatives-section.tsx - Alerts and audit
components/dashboard/alerts-section.tsx - Marketing intelligence
components/dashboard/intelligence-section.tsx
Meta Ads
- Meta API routes
app/api/meta - Meta Graph integration
lib/meta-api.ts - Meta Ads platform
Workspace management
- Client management
components/dashboard/clients-section.tsx - Connection management
components/dashboard/connections-manager.tsx - User administration
components/dashboard/users-section.tsx - Workspace settings
components/dashboard/settings-section.tsx
Identity and storage
- Session and role
lib/auth-context.tsx - Store data hooks
lib/use-store.ts - Workspace store API
app/api/store/[entity]/route.ts - Admin user API
app/api/admin/users/route.ts - Current-user API
app/api/me/route.ts - Admin authorization
lib/admin-guard.ts - Browser Supabase client
lib/supabase/client.ts - Server Supabase client
lib/supabase/admin.ts
Other components
- Dashboard user
- Supabase database and auth
Connections 27
- Dashboard user → App entry: opens
- App entry → Sign-in screens: renders
app/page.tsx - App entry → Dashboard shell: renders
app/page.tsx - Sign-in screens → Session and role: signs in through
components/auth/auth-screens.tsx - Session and role → Browser Supabase client: checks session
lib/auth-context.tsx - Session and role → Current-user API: fetches role
lib/auth-context.tsx - Current-user API → Admin authorization: gets requester
app/api/me/route.ts - Admin authorization → Server Supabase client: checks identity
lib/admin-guard.ts - Dashboard shell → Performance overview: renders
components/dashboard/dashboard-shell.tsx - Dashboard shell → Campaign hierarchy: renders
components/dashboard/dashboard-shell.tsx - Dashboard shell → Creative reporting: renders
components/dashboard/dashboard-shell.tsx - Dashboard shell → Alerts and audit: renders
components/dashboard/dashboard-shell.tsx - Dashboard shell → Marketing intelligence: renders
components/dashboard/dashboard-shell.tsx - Account and date filters → Meta API routes: loads status and accounts
- Meta API routes → Meta Graph integration: delegates to
app/api/meta/overview/route.ts - Meta Graph integration → Server Supabase client: reads connection token
lib/meta-api.ts - Meta Graph integration → Meta Ads platform: requests Graph API
lib/meta-api.ts - Client management → Store data hooks: creates and updates
components/dashboard/clients-section.tsx - Connection management → Store data hooks: manages connections
components/dashboard/connections-manager.tsx - Store data hooks → Workspace store API: fetches and mutates
lib/use-store.ts - Workspace store API → Server Supabase client: accesses records
app/api/store/[entity]/route.ts - User administration → Admin user API: administers users
- Workspace settings → Workspace store API: uses workspace data
- Admin user API → Admin authorization: checks requester
app/api/admin/users/route.ts - Admin user API → Server Supabase client: reads and writes users
app/api/admin/users/route.ts - Browser Supabase client → Supabase database and auth: authenticates
- Server Supabase client → Supabase database and auth: reads and writes