Streamly - Netflix-like streaming app

A single Next.js App Router project with API route handlers, authentication, profiles, HLS playback, and an admin CMS for uploads.

Live demo

https://streamly.sahilkhadtare.com

Prerequisites

• Node.js 20+
• Docker (for Postgres and optional MinIO)
• FFmpeg installed locally (ffmpeg -version)

Tech stack

• Next.js App Router + TypeScript (strict)
• Prisma + PostgreSQL
• NextAuth (Credentials provider)
• TailwindCSS + custom UI primitives
• Zustand for client state
• Zod validation
• HLS playback via hls.js with MP4 fallback

Environment variables

Copy .env.example to .env and adjust:

DATABASE_URL="postgresql://postgres:postgres@localhost:5432/streaming"
NEXTAUTH_SECRET="replace-me"
NEXTAUTH_URL="http://localhost:3000"
MEDIA_STORAGE="local"
LOCAL_MEDIA_DIR="./storage"
S3_ENDPOINT=""
S3_ACCESS_KEY=""
S3_SECRET_KEY=""
S3_BUCKET=""
S3_REGION="us-east-1"

Run locally (Node + Docker for Postgres)

1. Start Postgres (and optional MinIO):

   docker compose up -d db minio

2. Install deps:

   npm install

3. (Optional) Download demo media (seed no longer generates dummy assets):

   npm run demo:videos

4. Run migrations and seed:

   npm run db:migrate
   npm run db:seed

5. Start the app:

   npm run dev

Run everything with Docker Compose

docker compose up --build

The compose stack includes MinIO for S3-compatible storage at http://localhost:9001 (user/pass: minioadmin).

Seeded users

• Admin: [email protected] / Admin@12345
• Demo user: [email protected] / User@12345

Upload a demo video + generate HLS

1. Sign in as admin.
2. Create a movie or series under /admin.
3. For movies: open the title page and upload an MP4 (and optional poster/backdrop/VTT).
4. For series: create a season + episode, then upload the episode MP4.
5. Media jobs will show PROCESSING until HLS and thumbnail generation completes.

Download open-source demo videos (optional)

1. Download curated sample MP4s into local storage:

   npm run demo:videos

   This also extracts poster/backdrop JPGs from the videos. If you're using S3/MinIO, set DEMO_UPLOAD_TO_S3=true and the S3 env vars so uploads go to the bucket.
2. Run (or re-run) the seed to attach them:

   npm run db:seed

Storage modes

• Local (default): files stored under LOCAL_MEDIA_DIR and served via /api/media/*.
• S3/MinIO: set MEDIA_STORAGE=s3 and fill S3 env vars. Ensure the bucket exists (create media in MinIO) and is publicly readable for direct playback URLs.
  • If your app runs in Docker and MinIO is only reachable on the Docker network, set S3_PUBLIC_ENDPOINT to a host-accessible URL (e.g. http://localhost:9000) so browsers can load media.

Useful commands

npm run dev
npm run build
npm run start
npm run db:migrate
npm run db:seed

Notes

• Playback uses HLS when available; MP4 fallback is automatic.
• If you are running inside Docker, the container installs FFmpeg for processing.