How amir-baddour/airdropx works
AirDropX is a multi-tenant airdrop campaign platform with a React frontend for companies, administrators, and claimants; payouts are mocked. The frontend workflow routes users through authentication and company campaign management, while public pages support claims and status checks. Campaign setup includes task management, and admin screens expose oversight and moderation. The README documents Google OAuth, public campaign publishing, manual proof review, and payout lifecycle capabilities, but backend implementation is outside this tree. Edges reflect shown routing/imports and documented API or product relationships; unsampled feature-to-query calls are not inferred.
Main entry points: App.tsx Application router · queries.ts Query layer · AdminPage.tsx Admin console · AuthCallbackPage.tsx OAuth callback
Components 28
App routing
- Application router
frontend/src/App.tsx - Landing and docs
frontend/src/features/landing
Identity
- Google sign-in
frontend/src/features/auth/LoginPage.tsx - OAuth callback
frontend/src/features/auth/AuthCallbackPage.tsx - OAuth initiation
frontend/src/lib/auth.ts - Session storage
frontend/src/lib/session.ts - Protected routes
frontend/src/features/auth/RequireAuth.tsx
Company campaigns
- Campaign dashboard
frontend/src/features/dashboard/AirdropsPage.tsx - Create campaign
frontend/src/features/dashboard/CreateAirdropDialog.tsx - Campaign workspace
frontend/src/features/airdrop/AirdropPage.tsx - Task management
frontend/src/features/airdrop/TasksTab.tsx - Recipient management
frontend/src/features/airdrop/RecipientsTab.tsx - Claim review
frontend/src/features/airdrop/ClaimsTab.tsx - Campaign lifecycle
frontend/src/features/airdrop/LifecycleStepper.tsx
Claimant experience
- Public claim flow
frontend/src/features/public/ClaimPage.tsx - Public page shell
frontend/src/features/public/PublicShell.tsx - Claim status
frontend/src/features/public/StatusPage.tsx
Administration
- Admin console
frontend/src/features/admin/AdminPage.tsx - Platform overview
frontend/src/features/admin/AdminOverview.tsx - Company moderation
frontend/src/features/admin/AdminCompanies.tsx - Audit history
frontend/src/features/admin/AdminAudit.tsx
Other components
- Company user
- Claimant
- Administrator
- Query layer
frontend/src/lib/queries.ts - API client
frontend/src/lib/api.ts - Spark API
- DigitalOcean Spaces
Connections 30
- Company user → Application router: opens
- Claimant → Application router: opens
- Administrator → Application router: opens
- Application router → Landing and docs: routes
frontend/src/App.tsx - Application router → Google sign-in: routes
frontend/src/App.tsx - Application router → OAuth callback: routes
frontend/src/App.tsx - Application router → Public claim flow: routes
frontend/src/App.tsx - Application router → Claim status: routes
frontend/src/App.tsx - Application router → Protected routes: protects
frontend/src/App.tsx - Application router → Campaign dashboard: routes
frontend/src/App.tsx - Application router → Campaign workspace: routes
frontend/src/App.tsx - Application router → Admin console: routes
frontend/src/App.tsx - Google sign-in → OAuth initiation: starts sign-in
frontend/src/features/auth/LoginPage.tsx - OAuth initiation → OAuth callback: redirects
frontend/src/lib/auth.ts - OAuth callback → Session storage: saves session
frontend/src/features/auth/AuthCallbackPage.tsx - Protected routes → Session storage: checks session
frontend/src/features/auth/RequireAuth.tsx - Campaign dashboard → Create campaign: opens
frontend/src/features/dashboard/AirdropsPage.tsx - Create campaign → Query layer: creates via
frontend/src/features/dashboard/CreateAirdropDialog.tsx - Campaign workspace → Task management: shows tab
- Public claim flow → Public page shell: renders within
frontend/src/features/public/ClaimPage.tsx - Claim status → Public page shell: renders within
frontend/src/features/public/StatusPage.tsx - Admin console → Platform overview: renders
frontend/src/features/admin/AdminPage.tsx - Admin console → Company moderation: renders
frontend/src/features/admin/AdminPage.tsx - Admin console → Audit history: renders
frontend/src/features/admin/AdminPage.tsx - Platform overview → Query layer: loads metrics
frontend/src/features/admin/AdminOverview.tsx - Company moderation → Query layer: loads companies
frontend/src/features/admin/AdminCompanies.tsx - Task management → Query layer: loads tasks
frontend/src/features/airdrop/TasksTab.tsx - Query layer → API client: calls
frontend/src/lib/queries.ts - API client → Spark API: sends requests
- Spark API → DigitalOcean Spaces: publishes pages