A modern, fast, and responsive IPTV streaming web application built with React and powered by the IPTV-org database. Watch live TV channels from around the world with an intuitive grid-based interface.
⚠️ IMPORTANT: This repository is for portfolio and educational purposes only. See LICENSE for usage restrictions.
- 🌍 8,625+ Live Channels - Access channels from 179 countries worldwide
- 🎯 Smart Filtering - Filter by country (with full names) and category
- 🔍 Real-time Search - Instantly search through thousands of channels
- 📱 Fully Responsive - Optimized for desktop, tablet, and mobile devices
- 🎬 HLS Streaming - Adaptive streaming with HLS.js
- 🚀 Blazing Fast - Lazy loading and performance optimizations
- 🗺️ SEO Optimized - Comprehensive sitemaps for search engines
- 📡 Live API - Always up-to-date with IPTV-org database
- 🎨 Modern UI - Clean, intuitive interface with smooth animations
- Node.js (v16 or higher)
- npm or yarn
-
Clone the repository
git clone https://github.com/yourusername/fluxcast-frontend.git cd fluxcast-frontend -
Install dependencies
npm install
-
Run development server
npm run dev
-
Open your browser
http://localhost:5173
# Build the project (automatically generates sitemaps)
npm run build
# Preview production build
npm run previewThe build files will be in the dist folder.
-
Install Firebase CLI:
npm install -g firebase-tools
-
Login to Firebase:
firebase login
-
Initialize Firebase (if not already done):
firebase init hosting
-
Deploy:
firebase deploy
The dist folder can be deployed to any static hosting service:
- Vercel
- Netlify
- GitHub Pages
- Cloudflare Pages
- Frontend Framework: React 18
- Build Tool: Vite 5
- Routing: React Router v6
- Video Player: HLS.js
- Icons: Lucide React
- SEO: React Helmet Async
- API: IPTV-org Database
- Hosting: Firebase Hosting
fluxcast-frontend/
├── public/ # Static files
│ ├── manifest.json # PWA manifest
│ ├── robots.txt # SEO robots file
│ └── sitemap*.xml # Auto-generated sitemaps
├── scripts/
│ └── generate-sitemap.js # Live sitemap generator
├── src/
│ ├── components/ # Reusable components
│ │ └── Layout.jsx # Main layout wrapper
│ ├── pages/ # Page components
│ │ ├── Home.jsx # Channel grid
│ │ ├── Channel.jsx # Channel player
│ │ ├── About.jsx # About page
│ │ ├── Legal.jsx # Legal disclaimers
│ │ └── Privacy.jsx # Privacy policy
│ ├── utils/
│ │ └── countries.js # Country code mapping
│ ├── App.jsx # Main app component
│ ├── firebase.js # Firebase config
│ ├── main.jsx # App entry point
│ └── style.css # Global styles
├── .gitignore
├── firebase.json # Firebase config
├── index.html
├── LICENSE
├── package.json
├── README.md
└── vite.config.js
npm run dev- Start development servernpm run build- Build for production (includes sitemap generation)npm run preview- Preview production buildnpm run generate-sitemap- Manually generate sitemaps from live API
FluxCast fetches real-time data from the IPTV-org database, ensuring:
- Always current channel listings
- Active streams only (verified availability)
- Automatic updates with each build
- Automatically generated sitemaps (12 files)
- 8,625 individual channel pages
- 179 country filter pages
- 29 category filter pages
- Proper meta tags and structured data
- Daily lastmod updates
Full country names displayed instead of codes:
IN→IndiaUS→United StatesGB→United Kingdom- 179 total countries supported
Important Disclaimer:
This project is a web interface for publicly available IPTV streams from the IPTV-org database. FluxCast:
- Does NOT host any video content
- Does NOT provide any streaming infrastructure
- Does NOT modify or redistribute copyrighted content
- Only aggregates publicly available stream URLs
All content is the property of their respective copyright holders. Users are responsible for complying with local laws and respecting intellectual property rights.
This project uses the IPTV-org database, which is licensed under the Unlicense. We are grateful to the IPTV-org community for maintaining this comprehensive database.
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This is NOT open-source software. This repository is published for portfolio and educational purposes only.
- ✅ Allowed: View, study, and learn from the code
- ✅ Allowed: Use for educational purposes and personal learning
- ❌ Restricted: Production use without proper attribution
- ❌ Restricted: Commercial use without permission
- Production Site: https://tv.abhiyanpa.in/
- For Licensing Inquiries: Contact through GitHub issues
- Report Unauthorized Use: Open an issue with evidence
This application only provides access to publicly available streams from the IPTV-org database. All streaming content is the property of their respective copyright holders. Users are solely responsible for their use of this application and must comply with applicable laws in their jurisdiction.
This repository is for portfolio demonstration only. Any production use requires explicit attribution as detailed in the LICENSE. The author reserves all rights to enforce takedown of unauthorized derivative works.
Portfolio Project by Abhiyan PA © 2026
- About/Credits page
- FAQ page
-
Attribution Format:
Built using FluxCast by Abhiyan PA https://tv.abhiyanpa.in/ -
Include a working hyperlink to:
- Production site: https://tv.abhiyanpa.in/
- OR this GitHub repository
The copyright holder reserves the right to take down any website using this code without proper attribution. Violations will result in:
- DMCA takedown notices
- Hosting provider complaints
- Legal action if necessary
See LICENSE file for complete terms.
Live production version: https://tv.abhiyanpa.in/
- IPTV-org - For the comprehensive IPTV database
- HLS.js - For HLS streaming support
- Lucide Icons - For beautiful icons
- Vite - For blazing fast builds
For questions or support, please open an issue on GitHub.