/project-root
├── /public
│ ├── favicon.ico # App icon for browser tabs
│ ├── manifest.json # PWA configuration for installability
│ └── robots.txt # SEO rules for web crawlers
├── /src
│ ├── /assets
│ │ ├── logo.svg # Main application branding/logo
│ │ └── default-avatar.png # Fallback image for users without profile pics
│ ├── /components
│ │ ├── /common # Reusable, stateless UI elements
│ │ │ ├── Button.jsx # Standardized button with primary/secondary variants
│ │ │ ├── Input.jsx # Standardized text input for forms/search
│ │ │ ├── Toast.jsx # UI for the toast notification popup
│ │ │ └── Skeleton.jsx# Base shimmer loading animation component
│ │ ├── /layout # Structural page components
│ │ │ ├── Header.jsx # Top navigation bar component
│ │ │ ├── Sidebar.jsx # Desktop side navigation component
│ │ │ ├── MobileNav.jsx# Mobile bottom navigation bar
│ │ │ └── Layout.jsx # Wrapper combining Header, Sidebar, and Main content
│ │ └── /video # Video-specific UI components
│ │ ├── VideoCard.jsx # The 16:9 thumbnail and metadata display
│ │ ├── VideoGrid.jsx # CSS Grid wrapper for rendering multiple VideoCards
│ │ └── VideoPlayer.jsx # YouTube iframe embed wrapper
│ ├── /config
│ │ ├── firebase.js # Firebase initialization and service exports (auth, db)
│ │ └── blogger.js # Blogger API key, Blog ID, and base URL constants
│ ├── /context
│ │ ├── AuthContext.jsx # Global state for the currently logged-in user
│ │ └── ThemeContext.jsx# Global state for Dark/Light mode toggling
│ ├── /hooks
│ │ ├── useAuth.js # Custom hook to access Firebase auth functions easily
│ │ ├── useBlogger.js # Custom hook to fetch and paginate Blogger posts
│ │ └── useToast.js # Custom hook to trigger toast notifications globally
│ ├── /pages
│ │ ├── /public
│ │ │ ├── Home.jsx # Landing page with the main video feed
│ │ │ ├── Watch.jsx # Single video playback page
│ │ │ └── Search.jsx # Search results page
│ │ ├── /user
│ │ │ ├── Dashboard.jsx # User hub (history, liked videos, playlists)
│ │ │ └── Profile.jsx # User settings and account management
│ │ ├── /admin
│ │ │ └── AdminPanel.jsx# Protected route to manage Blogger posts via API
│ │ └── NotFound.jsx # 404 Error page for invalid URLs
│ ├── /services
│ │ ├── api.js # Axios/Fetch wrapper for network requests
│ │ ├── bloggerService.js# Functions: getVideos(), getVideoDetails(), searchVideos()
│ │ └── firebaseService.js# Functions: addToWatchLater(), likeVideo(), getUserData()
│ ├── /styles
│ │ ├── variables.css # CSS Custom Properties (Colors, Typography, Spacing)
│ │ ├── global.css # CSS Resets, body background, and font family declarations
│ │ └── layout.css # Grid/Flexbox rules for the structural layout components
│ ├── /utils
│ │ ├── formatters.js # Helper functions (e.g., formatViewCount, formatTimeAgo)
│ │ └── parseBlogger.js # Logic to convert Blogger JSON payload into App Video Objects
│ ├── App.jsx # Root React component, contains React Router setup
│ └── main.jsx # React DOM rendering entry point, wraps App in Context Providers
├── .env # Environment variables (API keys) - NOT committed to Git
├── .gitignore # Specifies files to ignore in Git (node_modules, .env)
├── index.html # The single HTML file serving the React app
├── package.json # NPM dependencies, scripts, and project metadata
└── vite.config.js # Vite bundler configuration (plugins, server settings)