🎥 Stream — Watch Together. Talk Together.

A modern video streaming platform with real-time video chat, enabling users to watch and interact simultaneously.
Built using React + Vite for blazing-fast performance and rapid development.

🚧 This project is a work in progress and under active development. New features coming soon!

---

🌐 Overview

Stream brings a social layer to streaming. Whether you're watching movies, shows, or live content — connect with friends in real-time via video chat while you stream.

🕹️ Retro Vibes Incoming!
Stream embraces a playful 8-bit retro aesthetic, with our pixel-powered mascot — Mario — cheering you on during your watch parties. Expect easter eggs, old-school icons, and bitcount vibes all around!

---

✨ Key Features (Planned & In Progress)

• 📺 Smooth video playback with custom player
• 🎤 Real-time video and audio chat between viewers
• 👥 Shared watch sessions (Watch Parties)
• 💬 Live chat and reactions
• 🔒 Authenticated user sessions
• 🎞️ Admin upload & video management
• 🕹️ Retro UI elements with pixel-art animations

---

⚙️ Tech Stack

Frontend

• React — Component-based UI library
• Vite — Fast build tool with instant HMR
• React Router — SPA routing
• Tailwind CSS — Utility-first CSS for custom UI
• React Hook Form + Zod — Robust form handling and validation
• Socket.IO / WebRTC (planned) — For real-time video/audio communication

Dev Experience

• ESLint + Prettier — Enforced code style and linting
• Vite Plugin React — Fast Refresh using Babel (option to switch to SWC)
• Git & GitHub — Version control and collaboration

---

🏗️ Project Structure

stream/
├── public/               # Static assets
├── src/
│   ├── components/       # Reusable UI components
│   ├── pages/            # Route-based pages
│   ├── hooks/            # Custom React hooks
│   ├── utils/            # Utility functions
│   ├── styles/           # Tailwind & global styles
│   └── main.jsx          # Entry point
├── .eslintrc.cjs         # ESLint config
├── vite.config.js        # Vite config
└── README.md             # You are here :)

---

🚧 Development Status

The foundation is being laid — core structure, routing, and layout are in progress.
Upcoming milestones include:

• User Authentication
• Video Player Integration
• Real-time Chat & WebRTC
• Watch Party Room Creation
• Admin Dashboard
• 🎮 Retro UI with Mario animations

---

📦 Getting Started

git clone https://github.com/yourusername/stream.git
cd stream
npm install
npm run dev

---

📣 Contributing

Contributions, feature requests, and ideas are welcome!
Please open an issue or create a pull request to get involved.

---

📝 License

This project is open source and available under the MIT License.

---

💡 Inspiration

Inspired by platforms like Twitch, Netflix Party, and YouTube Live, Stream aims to make content viewing a shared experience — no matter the distance.

And yes — for the 90s kids: get ready for coin sounds, pixel fonts, and maybe a few "It's-a me!" surprises along the way. 🍄

---