# BlackStream

BlackStream is a comprehensive streaming aggregation platform that solves the modern entertainment discovery problem. This app serves as a single interface for users to discover, track, and get intelligent recommendations across all their streaming services, eliminating platform fragmentation and decision fatigue.

## Project Structure

```
BlackStream/
├── frontend/            # Client-side applications (web, mobile)
│   ├── web-app/        # React web application
│   ├── mobile-ios/     # React Native iOS app (placeholder)
│   ├── mobile-android/ # React Native Android app (placeholder)
│   └── shared-components/ # Shared UI components and utilities
├── backend/             # Server-side microservices
│   ├── api-gateway/    # Entry point for all client requests (Express)
│   ├── recommendation-engine/ # ML recommendations (placeholder)
│   ├── content-aggregator/    # Aggregates catalogs across platforms (placeholder)
│   ├── sync-service/   # Synchronisation and co-watching (placeholder)
│   └── user-service/   # Authentication and user profiles (placeholder)
├── data/                # Database schemas, migrations, and seed data
│   ├── schemas/
│   ├── migrations/
│   └── seed-data/
├── infrastructure/      # Deployment scripts
│   ├── docker/
│   ├── kubernetes/
│   └── terraform/
├── docs/                # Documentation
│   ├── api-docs/
│   ├── architecture/
│   └── user-guides/
└── assets/
    └── images/         # Logos and marketing assets
```

---

This project is under active development. See the `docs/` directory for architecture, API usage, and user guides.