Project structure

.
├── app/                  # Next.js App Router pages and API routes
├── components/           # React components (Atomic Design)
├── contexts/             # React context providers
├── hooks/                # Custom React hooks
├── lib/                  # Utility functions and static data
├── utils/                # Infrastructure helpers (Supabase client)
├── styles/               # Feature-specific CSS files
├── types/                # TypeScript type declarations
├── public/               # Static files served as-is
├── docs/                 # Internal docs and Supabase migration files
├── middleware.ts          # Auth session refresh middleware
├── next.config.mjs       # Next.js build configuration
├── tailwind.config.js    # Tailwind CSS configuration
├── tsconfig.json         # TypeScript compiler options
└── components.json       # shadcn/ui registry configuration

app/
├── page.tsx                        # / — main landing page
├── layout.tsx                      # Root layout (providers, fonts, metadata)
├── globals.css                     # Global styles and CSS custom properties
├── registration/
│   └── page.tsx                    # /registration — multi-step registration form
├── schedule/
│   └── page.tsx                    # /schedule — interactive event timeline
├── community-seva/
│   └── page.tsx                    # /community-seva — community service form
├── spiritual-seva/
│   └── page.tsx                    # /spiritual-seva — spiritual service form
├── guest-services/
│   └── page.tsx                    # /guest-services — guest info page
├── admin/
│   └── registrations/
│       ├── page.tsx                # /admin/registrations — protected dashboard
│       └── unauthorized/
│           └── page.tsx            # /admin/registrations/unauthorized
├── auth/
│   └── callback/
│       └── route.ts                # /auth/callback — OAuth redirect handler
└── api/
    └── download/
        └── route.ts                # /api/download — URL-allowlisted R2 proxy

components/atoms/
├── loading-screen        # Full-page loading overlay shown on initial load
├── theme-provider        # next-themes wrapper (forced to light mode)
├── typewriter            # Animated character-by-character text reveal
└── scroll-to-top         # Floating button to scroll back to page top

components/molecules/
├── guru-card             # Profile card for spiritual leaders
├── date-picker           # react-day-picker integration with custom styling
├── phone-input           # react-phone-number-input integration
└── countdown-timer*      # Event countdown with days/hours/minutes/seconds

components/organisms/
├── navigation            # Desktop + mobile navigation with floating menu button
├── floating-menu-button  # Mobile FAB menu
├── sticky-footer         # Persistent footer with temple info and links
├── carousels             # Embla Carousel-based image carousels
├── galleries             # Photo gallery grids with lightbox
├── forms/
│   ├── registration-form # Multi-step registration form (React Hook Form + Zod)
│   ├── seva-form         # Shared seva submission form base
│   └── *
├── timeline              # Event schedule timeline (mobile + desktop variants)
├── video-schema          # JSON-LD VideoObject structured data
└── *                     # Additional section organisms (hero, stats, etc.)

components/templates/
└── *                     # Page layout shells

components/ui/
├── accordion.tsx
├── alert-dialog.tsx
├── badge.tsx
├── button.tsx
├── calendar.tsx
├── card.tsx
├── checkbox.tsx
├── dialog.tsx
├── dropdown-menu.tsx
├── input.tsx
├── label.tsx
├── popover.tsx
├── progress.tsx
├── select.tsx
├── separator.tsx
├── sheet.tsx
├── skeleton.tsx
├── sonner.tsx
├── table.tsx
├── tabs.tsx
├── toast.tsx
├── tooltip.tsx
└── *

contexts/
└── audio-context.tsx     # AudioProvider + useAudioContext hook
                          # Manages HTMLAudioElement, fade controls,
                          # user-consent gating, and playback state

hooks/
├── use-audio.ts                # Low-level audio playback utilities
├── use-device-type.ts          # Detect mobile vs. desktop viewport
├── use-intersection-observer.ts # Scroll-based animation triggers (IntersectionObserver)
├── use-loading.tsx             # LoadingProvider + useLoading hook for global loading state
└── use-toast.ts                # Toast notification queue (used by Sonner)

lib/
├── cdn-assets.ts         # Cloudflare R2 and Cloudflare Images URL helpers
│                         #   getCloudflareImage(id) → bigger variant
│                         #   getCloudflareImageMobileWp(id) → mobileWP variant
│                         #   getCloudflareImageBiggest(id) → biggest variant
├── timeline-data.ts      # Static event schedule and timeline entries
├── admin-auth.ts         # ALLOWED_DOMAIN constant and domain validation logic
└── utils.ts              # Shared utility functions (cn, etc.)

utils/
└── supabase/
    ├── client.ts         # Browser-side Supabase client
    ├── server.ts         # Server-side Supabase client (for Server Components)
    └── middleware.ts     # updateSession() called by root middleware.ts

styles/
├── registration.css      # Registration form custom styles
├── admin.css             # Admin dashboard custom styles
└── community.css         # Community seva page custom styles

{
  "paths": {
    "@/*": ["./*"]
  }
}