Lists

App that keeps track of movies, TV shows, games, books and various other things. This project exists because I'd rather manage these in one self-hosted location instead of multiple third-party services, such as Letterboxd, Goodreads or the Steam Library.

Prerequisites

API:

• Ruby >= 2.6
• Bundler
• PostgreSQL >= 13
• Redis
• Imagemagick >= 7

UI:

• Node >= 22

Ensure that postgres and redis servers are running (listening to default ports).

Installation

API (cd api):

1. Install dependencies:

   bundle install

2. Setup database:

   ./bin/rails db:setup

3. Apply migrations:

   ./bin/rails db:migrate

UI (cd ui):

1. Install dependencies:

   npm install

Running

API (cd api):

brew services start postgresql@14
brew services start redis
./bin/rails server

UI (cd ui):

npm run dev

Then visit http://localhost:3001.

Running tests

API (cd api):

./bin/rails test

UI (cd ui):

npm run test

OPS

The top level directory contains some convenience scripts to help with deploying and spawning remote shells.

• deploy: Builds and deploys backend and frontend to lists.rathr.io
• redis: Spawns a redis-cli in the redis container
• postgres: Spawns a psql shell in the postgres container
• web: Spawns a shell in the web container

APIs used

Lists relies on the following APIs to scrape meta info:

• Movies / TV Shows: The Movie DB
  • https://developer.themoviedb.org/reference/intro/getting-started
• Video Games: IGDB
• Books: Google Books
• Recipes: Edaman