The target of TevTube is to provide a premium, lighting-fast, and fully responsive YouTube experience that mirrors the 2026 YouTube UI. It aims to showcase how modern web technologies like React, Tailwind CSS, and Clerk can be harmonized to build a high-fidelity platform capable of handling real-time data from the YouTube API.

Standard video platforms and clones often suffer from:

• Poor Mobile Responsiveness: Layouts break or become unusable on smaller screens.
• Inconsistent UI: Lack of attention to detail regarding spacing, typography, and interactive states.
• Complex Authentication: Implementation of secure, seamless user management is often an afterthought.
• Data Latency: Large volumes of video data can lead to slow, unoptimized loading states.

TevTube addresses these challenges through:

• Mobile-First Responsive Design: Every component, from the sidebar to the video player, is meticulously crafted to adapt to any screen size without horizontal scrolling.
• High-Fidelity UI/UX: Utilizing Shadcn/UI and Framer Motion to deliver smooth animations, premium typography (Outfit), and a pixel-perfect dark/light mode experience.
• Integrated Clerk Authentication: Secure, enterprise-grade authentication with a custom-styled logout flow integrated directly into the sidebar.
• Optimized Loading States: Customized Skeleton Loaders for every page (Home, Watch, Search) to eliminate layout shifts and provide instant visual feedback.

graph TD
    A[User visits TevTube] --> B{Authenticated?}
    B -- Yes --> C[Display Personalized Feed]
    B -- No --> D[Display Trending Videos]
    
    C --> E[YouTube API Service]
    D --> E
    
    E --> F[Zustand State Store]
    F --> G[Components: VideoCard, Navbar, etc.]
    
    G --> H[User Interacts]
    H --> I{Action?}
    I -- Search --> J[Search API Call]
    I -- Watch --> K[Video Details API Call]
    I -- Menu --> L[Toggle Sidebar State]

graph LR
    Desktop[Desktop View] -->|Breakpoints| Tablet[Tablet View]
    Tablet -->|Breakpoints| Mobile[Mobile View]
    
    Desktop --> FullSidebar[Full Sidebar - 240px]
    Tablet --> MiniSidebar[Mini Sidebar - 72px]
    Mobile --> DrawerSidebar[Mobile Drawer - Overlay]
    
    Desktop --> MultiCol[4-Column Grid]
    Mobile --> SingleCol[1-Column Stack]

• Home Page: Dynamic trending feed with category filters.
• Search: Real-time video search with detailed result cards.
• Watch Page: Premium video player with related videos, comments, and responsive reordering.
• Shorts: Mobile-optimized vertical scrolling shorts feed.
• Notifications: Integrated UI for user alerts.
• Dark Mode: Complete system-themed or manual dark/light toggle.
• User Management: Custom profile page and history dashboard.
• Live Stream Support: High-fidelity badges for live content.

1. Clone the repo

   git clone https://github.com/JonniTech/YouTube-Clone.git

2. Install dependencies

   yarn install

3. Setup Environment Variables Create a .env file and add your keys:

   VITE_CLERK_PUBLISHABLE_KEY=your_key
   VITE_YOUTUBE_API_KEY=your_key

4. Start Development Server

   yarn dev

• Clarity: High contrast and clear typography.
• Feedback: Immediate visual cues for every interaction (skeletons, hover effects).
• Premium Feel: Subtle gradients, rounded corners, and generous whitespace.

Programmed by NYAGANYA