OpenTv Monorepo

Welcome to the OpenTv monorepo! This repository contains the complete ecosystem for the OpenTv platform, separated into three main workspaces.

📁 Repository Structure

1. opentv-app (Mobile & TV App)

A powerful React Native (Expo) application built for Android TV, Fire TV, and mobile devices. It features:

• High-performance IPTV streaming.
• Support for remote control interactions (TVEventHandler).
• Massive built-in channel lists (World Cup, FIFA, TV Networks).
• 👉 View the App Source Code & Details
• 👉 View the IPTV Playlists

2. opentv-server (Backend API)

The core backend server built with Express and Prisma. It handles:

• User Authentication (JWT-based).
• API Routes and Swagger UI Documentation.
• Data management for categories, streams, and users.
• 👉 View the Server Source Code & Details

3. dashboard (Admin Panel)

A modern, premium React/Vite dashboard for managing the platform. It features:

• Glassmorphism design and modern CSS.
• Fast, responsive interface.
• Easy management of content streams and users.
• 👉 View the Dashboard Source Code & Details

---

🚀 Getting Started

Prerequisites

Make sure you have Node.js and Yarn installed on your machine.

Installation

Because this is a Monorepo using Yarn Workspaces, you can install the dependencies for all three projects at once by running the following command in the root folder:

yarn install

Running the Projects

To run the React Native TV App:

cd opentv-app
yarn run android

To run the Backend Server:

cd opentv-server
npm run dev

To run the Admin Dashboard:

cd dashboard
npm run dev

Build React Native Android App (Expo)

1. Navigate to the project

cd opentv-app

2. Generate the native Android project

npx expo prebuild --clean

3. Run the app on an Android device/emulator

yarn android

or

yarn run android

4. Build a Preview APK/AAB using EAS (Cloud)

eas build -p android --profile preview

5. Build locally (requires Android SDK, Java, and NDK if needed)

eas build -p android --profile preview --local

Requirements

• Node.js
• Yarn
• Expo CLI
• EAS CLI

Install EAS CLI if you haven't already:

npm install -g eas-cli

Log in to your Expo account:

eas login

Configure EAS in your project:

eas build:configure

Output

• Cloud build: Download the APK/AAB from the Expo build page after the build completes.
• Local build: The APK/AAB will be generated on your local machine, and the build output will display its location.a