Luganda translated movies and series
# MuviHub UG Cinema — React Native / Expo Go App
A modern streaming platform app for Ugandan cinema with Luganda commentary.
Built with **Expo Router**, compatible with **Expo Go** and deployable to **Vercel**.
---
## 🚀 Quick Start
### Prerequisites
- Node.js 18+
- Expo CLI: `npm install -g expo`
### Install
```bash
npm install
```
### Run (Development)
```bash
# Start Expo dev server (scan QR code with Expo Go)
npx expo start
# Web (browser)
npx expo start --web
# Android
npx expo start --android
# iOS
npx expo start --ios
```
---
## 🌐 Deploy to Vercel
```bash
# 1. Build static web export
npx expo export --platform web
# 2. Deploy to Vercel
vercel deploy --prod
# Or connect your GitHub repo to Vercel:
# - Build Command: npx expo export --platform web
# - Output Directory: dist
# - Install Command: npm install
```
The `vercel.json` file is pre-configured with proper rewrites and caching headers.
---
## 📱 Expo Go (Mobile)
1. Install Expo Go on your phone
2. Run `npx expo start`
3. Scan the QR code
---
## 🎬 Key Features
### ExoPlayer (Android) / AVPlayer (iOS)
- Uses `expo-video` which automatically uses ExoPlayer on Android
- Native video playback with hardware acceleration
- Supports HLS, MP4, and other formats
### Ketch Downloader Integration
- Download button opens **Ketch Downloader** deep link on Android
- Ketch enables fast, resumable background downloads
- Falls back to browser download on web
- Shows Play Store link if Ketch is not installed
### Fast Image Loading
- Uses **expo-image** with `memory-disk` cache policy
- Optimized TMDB image sizes (w185 for cards, w780 for heroes)
- Transition animations for smooth loading
### Firebase Integration
- Firebase Auth (email/password)
- Firebase Realtime Database for movies, series, episodes
- Firebase Storage for profile pictures
---
## 🗂️ Project Structure
```
app/
_layout.tsx # Expo Router root layout
index.tsx # Main app with all state management
components/
SplashScreen. …