Skip to content
raajnadarPublic

About

A film browser for iOS, Android, and the web, built with Expo Router and RootNative UI (Material Design 3). Search TMDB, browse genres and cast, play trailers, and keep an offline watchlist.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

168 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Reelist logo

Reelist

Browse films, watch trailers, and keep a watchlist.
One codebase for iOS, Android, and the web.

CI status Web deploy status Expo SDK 58 React Native 0.88 Platforms: iOS, Android, and web MIT license

Open the web app · Try it on a phone · Quick start · Documentation

The Reelist home screen in a browser, with the navigation rail, the genre chips, and the trending carousel

✨ Features

Feature What it does
Film lists Trending this week, Popular, Top rated, and Popular in the language of your device.
Film colours Each film page takes its theme from the main colour of its poster, in light and in dark.
Trailers and stills The trailer plays inside the app. On Android it keeps playing in a small window when you leave. The gallery shows the stills of the film.
Cast and people A cast card opens the person, with each film they appear in, newest first. The director and the writers are named too.
Film page extras Where to watch, reviews, similar films, the franchise the film is part of, and links to IMDb and the official site.
Genres An endless grid for each genre. A filter sheet sorts it by popularity, rating, or release date, and filters it by decade, minimum rating, runtime, and one or more languages. The filters stay in the link.
Search The results change as you type. On the web, / opens the search from any page.
Watchlist It stays on the device, so it opens offline. It has "To watch" and "Watched" tabs, select mode, and undo.
Adaptive navigation A bar on a phone, a rail on a tablet or a laptop, and a drawer on a wide screen.
Light and dark System, Light, or Dark. Material Design 3 makes all the colours from one seed colour.
No key in the app The TMDB key stays on a server proxy. The app never holds it.

The film page of Dune: Part Two. The buttons and the rating use the orange of its poster.
Each film page takes its colours from the poster.

📱 Try it

The home screen on a phone, with the trending carousel and the floating navigation bar   The film page of Dune: Part Two on a phone, in the colours of its poster   The watchlist on a phone: 3 of 8 films watched

On a phone In a browser
QR code that opens Reelist in Expo Go
Scan with Expo Go on Android,
or with the Camera app on iOS.
reelist.raajnadar.in

It updates on every push to main.
You do not need an install or an account.

The QR code always serves the newest commit on main. You do not need this repository or a development server. The app runs on Expo Go SDK 58. Update Expo Go if it reports a version mismatch.

The code does not scan?

Open this link on the phone:

exp://u.expo.dev/7fe1b9fe-fa75-406c-aaf9-ae330957fc46?channel-name=main

Note

The browser build has no gestures and no native animation driver, so the carousel feels different there. Use the phone build to judge the motion.

🚀 Quick start

You need Node.js 24 or later, Yarn 1, the Vercel CLI, and a TMDB API key (v3 auth, 32 characters).

git clone https://github.com/raajnadar/reelist.git
cd reelist
yarn install
yarn --cwd proxy install

Terminal 1: the proxy. It holds the TMDB key.

cd proxy
vercel link                                     # once, to connect the project
echo "TMDB_API_KEY=<your v3 key>" > .env.local
vercel dev                                      # serves http://localhost:3000/api/tmdb

Terminal 2: the app.

cp .env.example .env
# Set EXPO_PUBLIC_TMDB_PROXY_URL=http://localhost:3000/api/tmdb in .env
yarn start                                      # then press i, a, or w

Important

Put the TMDB key only in proxy/.env.local. A key in the app's .env ships to every user. Read why.

Tip

Metro caches .env when it starts. Run yarn start --clear after you change it. On a phone, use the network address of your computer, not localhost.

The full setup, the scripts, and the tests are in docs/development.md.

🧭 How it works

flowchart LR
  subgraph app ["Reelist app: iOS, Android, web"]
    direction LR
    screens["Screens"] --> api["lib/api.ts<br/>the only data seam"]
    api --> transport["lib/tmdb.ts<br/>calls the proxy"]
    screens --> watchlist[("Watchlist<br/>on the device")]
  end
  transport -- "no key" --> proxy["Proxy on Vercel<br/>key, rate limit, edge cache"]
  proxy -- "adds the key" --> tmdb[("TMDB API")]
Loading
  • One seam. Every screen gets its data from lib/api.ts and from nowhere else. Two changes of the data source did not touch a screen.
  • One loader. Each screen loads through useResource, which keeps each answer for five minutes. A return to a screen draws it on the first frame.
  • One device store. The watchlist is the only state on the device. It keeps each film whole, so it opens offline.

Read the full design notes in docs/architecture.md and docs/design-system.md.

🧰 Tech stack

Layer Technology
App Expo SDK 58, Expo Router, React Native 0.88, React 19, TypeScript
UI RootNative UI: @rootnative/core, @rootnative/components, @rootnative/inertia
Images expo-image, with a memory cache and a load fade
Proxy Vercel Functions, with an Upstash Redis rate limit
Web A static export, prerendered film pages, and @rootnative/seo checks
Tests Jest and @testing-library/react-native
Delivery GitHub Actions, GitHub Pages, EAS Update, and EAS Build

📚 Documentation

Page Read it to
Development Set up the app, run the scripts and the tests, and find your way in the code
Architecture Learn how the data flows, why the key stays on a server, and how the watchlist works
Built with RootNative UI Learn about the themes, the film colours, the motion, and the navigation
Deployment Publish the web build, an app update, or a store build
The TMDB proxy Run, test, and deploy the proxy

🙏 Credits

  • Film data and images come from TMDB. This product uses the TMDB API but is not endorsed or certified by TMDB.
  • Trailers play from YouTube.
  • RootNative UI draws every screen.

📄 License

MIT © 2026 Rajendran Nadar

About

A film browser for iOS, Android, and the web, built with Expo Router and RootNative UI (Material Design 3). Search TMDB, browse genres and cast, play trailers, and keep an offline watchlist.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Contributors

Languages