ZenTube is a modern, mindful video streaming application built with React that promotes healthy viewing habits while providing an excellent user experience. It combines the familiar YouTube-like interface with digital wellbeing features to help users maintain a balanced relationship with video content.

• Home Feed: Browse trending and popular videos by category
• Search Functionality: Find videos with intelligent search capabilities
• Video Categories: Filter content by different categories (Music, Gaming, News, etc.)
• Video Player: Full-featured video player with playback controls
• Responsive Design: Optimized for desktop, tablet, and mobile devices

• Watch History: Keep track of all videos you've watched
• Watch Later: Save videos to watch at a convenient time
• Liked Videos: Bookmark your favorite content
• Smart Organization: Search and filter your saved content
• Bulk Actions: Clear all videos or remove individual items

• Daily Watch Time Tracking: Monitor your daily video consumption
• Watch Time Targets: Set daily limits to maintain healthy viewing habits
• Take a Break Reminders: Get notifications to take regular breaks (15min - 2hrs intervals)
• Progress Visualization: Beautiful circular progress indicators and statistics
• Wellbeing Dashboard: Comprehensive overview of your viewing patterns

• User Profiles: Personalized user accounts with random name generation
• Theme Switching: Choose between Light, Dark, or System themes
• Settings Management: Customize your viewing experience
• Data Management: Full control over your personal data

• Clean Interface: Minimalist design focused on content
• Smooth Animations: Fluid transitions and micro-interactions
• Accessibility: Built with accessibility best practices
• Component Library: Consistent design system using shadcn/ui
• Typography System: Consistent text styling throughout the app

• Node.js (version 16 or higher)
• npm or yarn package manager
• Modern web browser

1. Clone the repository

   git clone https://github.com/your-username/zentube.git
   cd zentube

2. Install dependencies

   npm install
   # or
   yarn install

3. Start the development server

   npm run dev
   # or
   yarn dev

4. Open your browser Navigate to http://localhost:5173 to see the application

1. First Visit: When you first open ZenTube, you'll be assigned a random username
2. Browse Content: Explore the home feed with trending videos
3. Search Videos: Use the search bar to find specific content
4. Watch Videos: Click on any video to start watching

• All videos you watch are automatically saved to your history
• Access history from the sidebar navigation
• Search through your watch history
• Remove individual videos or clear all history

• Click the three-dot menu on any video to add to Watch Later or Liked Videos
• Access these collections from the sidebar
• Organize and manage your saved content

1. Access Settings: Click on your profile icon and go to Account

2. Digital Wellbeing Section:

   • Toggle "Daily Watch Time Target" to set viewing limits
   • Set your target hours and minutes per day
   • Enable "Take a Break" reminders
   • Choose break intervals (15 minutes to 2 hours)

3. Monitor Progress: Visit the Digital Wellbeing page to see:

   • Today's watch time with visual progress
   • Remaining time until your daily limit
   • Wellbeing statistics and tips

• Light Theme: Clean, bright interface for daytime use
• Dark Theme: Easy on the eyes for low-light environments
• System Theme: Automatically matches your device's theme preference

• Change your username in the Account settings
• View your last active time
• Manage all your personal data

• Frontend Framework: React 19 with TypeScript
• Styling: Tailwind CSS v4 with CSS Modules
• UI Components: shadcn/ui component library
• State Management: Redux Toolkit (RTK)
• Data Fetching: RTK Query
• Routing: React Router v7
• Icons: Font Awesome
• Build Tool: Vite
• Storage: Local Storage for user data persistence

ZenTube is fully responsive and works seamlessly across:

• Desktop: Full-featured experience with sidebar navigation
• Tablet: Optimized layout with touch-friendly controls
• Mobile: Compact interface with collapsible navigation

• Local Storage: All user data is stored locally in your browser
• No Tracking: ZenTube doesn't track your behavior across the web
• Data Control: You have full control over your data with options to clear everything
• No Account Required: Use the app without creating accounts or providing personal information

ZenTube is designed with mindful consumption in mind:

• Awareness: Help users understand their viewing patterns
• Control: Provide tools to set and maintain healthy limits
• Balance: Encourage regular breaks and mindful watching
• Transparency: Clear visibility into time spent watching content

• Built with shadcn/ui for beautiful, accessible components
• Icons provided by Font Awesome
• Inspired by the need for more mindful digital experiences

Start your mindful viewing journey with ZenTube today! 🧘‍♀️📺