Browse films, watch trailers, and keep a watchlist.
One codebase for iOS, Android, and the web.
Open the web app · Try it on a phone · Quick start · Documentation
| 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. |
Each film page takes its colours from the poster.
| On a phone | In a browser |
|---|---|
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.
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 installTerminal 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/tmdbTerminal 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 wImportant
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.
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")]
- One seam. Every screen gets its data from
lib/api.tsand 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.
| 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 |
| 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 |
- 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.
MIT © 2026 Rajendran Nadar
