KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agent #developer-tools #codex #typescript #cli #deepseek-harness #claude-code #ai-agents #mcp #rust

Luma

★ 25 Open GitHub ↗

🎬 An open-source movie streaming platform.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Luma

<p align="center">
  English · <a href="README_CN.md">中文</a>
</p>

> **Luma** is a cross-platform streaming aggregation app built with **Next.js 14**, **Tailwind CSS**, and **TypeScript**.

![Next.js](https://img.shields.io/badge/Next.js-14-000?style=for-the-badge&logo=nextdotjs)
![TailwindCSS](https://img.shields.io/badge/TailwindCSS-3-38bdf8?style=for-the-badge&logo=tailwindcss)
![TypeScript](https://img.shields.io/badge/TypeScript-4.x-3178c6?style=for-the-badge&logo=typescript)
![License](https://img.shields.io/github/license/Gerard-Devlin/Luma?style=for-the-badge)
![Docker Ready](https://img.shields.io/badge/Docker-ready-blue?style=for-the-badge&logo=docker)
![Cloudflare](https://img.shields.io/badge/Cloudflare-Worker-F38020?style=for-the-badge&logo=cloudflare&logoColor=white)
![Redis](https://img.shields.io/badge/Redis-Powered-dc382d?style=for-the-badge&logo=redis&logoColor=white)
![TMDB](https://img.shields.io/badge/TMDB-Enhanced-01b4e4?style=for-the-badge)
![Stars](https://img.shields.io/github/stars/Gerard-Devlin/Luma?style=for-the-badge&logo=github&logoColor=white&color=7c3aed)

</div>

---

## Features

- 🔎 **Multi-source search**: Search across configured providers and get aggregated results in one place.
- 🎬 **TMDB metadata enrichment**: Posters, backdrops, ratings, cast, collections, and recommendations.
- 🌐 **Multilingual interface**: Switch between English and Chinese, with TMDB requests following the selected language.
- 🧠 **Personalized recommendation engine**: Build watch-history-aware discovery rails from TMDB recommendations, similar titles, keywords, credits, and ranking signals.
- 🍿 **Movie and TV discovery**: Browse movies, series, curated categories, years, ratings, and runtime filters.
- ⭐ **Favorites and continue watching**: Save favorites, watch history, playback progress, and resume points.
- 🗄️ **Multiple storage backends**: localStorage, Redis, Cloudflare D1, and Upstash Redis.
- 👤 **User management and verified registration**: Manage users from `/admin`, store accounts in D1 or Redis, and require email confirmation before new accounts are activated.
- ✉️ **Polished transactional email**: Send branded verification emails with Resend and React Email templates, including site logo, confirmation CTA, fallback link, and GitHub link.
- 🛠️ **Runtime admin panel**: Manage site settings, users, providers, categories, and system options from `/admin`.
- 📱 **PWA ready**: Offline cache, home-screen installation, and a mobile-friendly experience.
- 🖥️ **Responsive layout**: Desktop sidebar, mobile bottom navigation, and large-screen content rails.

## Screenshots

## Quick Start

```bash
pnpm install
pnpm dev
```

The development server runs at `http://localhost:3000` by default.

## Deployment

For Docker, Vercel, Cloudflare Workers, storage backends, and environment variables, see [DEPLOYMENT.md](DEPLOYMENT.md).

## Tech Stack

| Area               | Main Dependencies                                                         |
| ------------------ | ------------------------------------------------------------------------- |
| Framework          | [Next.js 14](https://nextjs.org/) App Router                              |
| UI and Styling     | [Tailwind CSS 3](https://tailwindcss.com/), next-themes, Framer Motion    |
| Language           | TypeScript 4                                                              |
| Data and Storage   | localStorage, Redis, Cloudflare D1, Upstash Redis                         |
| Auth and Email     | Username/password login, verified email registration, Resend, React Email |
| Content Enrichment | TMDB API, category feeds, image proxy                                     |
| Code Quality       | ESLint, Prettier, Jest                                                    |
| Deployment         | Docker, Vercel, Cloudflare Workers, OpenNext                              |

## License

## Acknowledgements

- [Next.js](https://nextjs.org/) and [Tailwind CSS](https://tailwindcss.com/): The application framework and styling foundation.
- Thanks to the maintainers of the open-source projects, metadata services, and provider APIs that make this project possible.

Luma

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README