Skip to content
Glory42Public

About

A social platform for film and TV discovery, reviews, and watch tracking. Built from scratch, optimized for performance, and shaped by how I actually want these platforms to work.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Interis

Every watch, remembered.

A social diary for films and TV. Log what you watch, rate it from 0.5 to 10 rockets, track shows one episode at a time, and see what the people you follow are watching.

Open Interis · Public API docs · Contributing · Report a bug

Test Suite License: GPL v3

Interis home page with an example diary and this week's trending films and TV

Features

  • Diary — log films and episodes with a date, a 0.5–10 rocket rating, rewatches, likes and an optional review
  • Films & TV — browse trending titles and an archive filtered by genre, language and sort, with director and actor pages
  • TV tracking — follow series season by season and episode by episode
  • Social feed — follow people and get a timeline of their logs, reviews, lists and posts
  • Profiles — public pages with favourites, diary, reviews, likes, watchlist, lists and stats
  • Themes — four hand-made themes, from a pure-black terminal to a cream cinema lobby
  • Public API — read-only endpoints for embedding your diary in your own site

Screenshots

Profile Diary
A public profile with favourite films and series and recent activity A profile's diary, grouped by month with rocket ratings
Film page TV page
The film page for Third Star with ratings, synopsis and credits The TV page for Re:ZERO with ratings, synopsis and credits

The films archive with a trending reel and genre, sort and language filters

Themes

Rose Pine, NULL://LOG, Nitrate and Marquee — pick one in settings, or add your own.

The same profile in the Rose Pine, NULL://LOG, Nitrate and Marquee themes

Public API

Anyone can read a user's public data, with no key, from https://api.interis.gorkemkaryol.dev/api/public/:username/* — profile, recent activity, diary, reviews, lists, likes, watchlist and top 4.

curl https://api.interis.gorkemkaryol.dev/api/public/glory42/top4

See the API docs for every endpoint, response shapes and rate limits.

Tech stack

Frontend React 19, Vite, TanStack Router + Query, Tailwind CSS v4, Radix/shadcn
Backend Bun, Express 5, TypeScript, Zod, in-house JWT auth
Data PostgreSQL (Neon) with Drizzle ORM; TMDB fetched on demand and cached
Storage Cloudflare R2 for avatars
Hosting Render (API), Cloudflare Pages (web + docs)

Running locally

With Docker installed:

git clone https://github.com/Glory42/Interis.git
cd Interis
docker compose up

This starts Postgres, applies migrations, and runs the API on http://localhost:5000 and the app on http://localhost:5173. Copy .env.example to .env first and add a TMDB_ACCESS_TOKEN if you want real film and TV data.

For running without Docker, tests and quality checks, see CONTRIBUTING.md.

Project layout

apps/
├── api/    Express API — domain modules, Drizzle schema and migrations
├── web/    React app
├── docs/   Astro + Starlight site for the public API
└── e2e/    Playwright smoke tests

Documentation

Read this For
CONTRIBUTING.md Setup, architecture, conventions, testing, CI
apps/api/README.md Backend modules, env vars, API surface
apps/web/README.md Frontend structure
apps/docs/README.md Working on the API docs site
ADDING-THEMES.md Adding a theme
DEPLOYMENT.md Deploying to Render and Cloudflare Pages
CONTEXT.md and docs/adr Domain language and architecture decisions

Contributing

Issues and pull requests are welcome — start with CONTRIBUTING.md. By taking part you agree to the Code of Conduct. Please report security issues privately as described in SECURITY.md.

License

GPL-3.0. Film and TV data and images come from TMDB; Interis uses the TMDB API but is not endorsed or certified by TMDB.

About

A social platform for film and TV discovery, reviews, and watch tracking. Built from scratch, optimized for performance, and shaped by how I actually want these platforms to work.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Contributors

Languages