limited-or-not

Check if any TV Show is a miniseries.

A miniseries is a television show that tells a story in a predetermined, limited number of episodes.

Getting started

Prerequisites

• Bun (v1.2.5 or higher)
• Node.js (v18 or higher)
• Svelte (v5.27.0 or higher)
• TMDB API Key (register at The Movie Database)

Setting up environment variables

1. Server variables

Create a .env file to the /server directory with the following entry:

TMDB_API_KEY=<your-api-key>

Replace <your-api-key> with your actual TMDB API key and ensure you save the file.

Bun will take care of sourcing and loading the environment variables.

2. Client variables

Create a .env file to the /client directory with the following entry:

SERVER_URL=http://localhost:3000

Svelte-kit will take care of sourcing and loading the environment variables.

Dependency management

This app uses Bun to manage dependencies for both the back end (/server) and front end (/client). From the root directory, install dependencies with:

# For the back end  
cd server && bun install  

# For the front end  
cd client && bun install  

Run the following to add, remove, or upgrade packages:

• Add a package: bun add package-name
• Remove a package: bun remove package-name
• Upgrade all dependencies: bun upgrade

Bun automatically generates a bun.lock file for deterministic installs. Ensure this file is committed to version control for consistensy across different environments.

Starting development servers

Start the back end and front end development servers using:

# For the Back End
cd server && bun .

# For the front End
cd client && bun run dev --open  

Run each command in a separate terminal window. Ensure both servers are running for full functionality.

Running tests

To run unit tests using Bun, use the following command from any directory within the project:

bun test

Managing OpenAPI documentation

To update the server docs with tsoa & Redocly, refer to the following commands:

# Generate updated OpenAPI spec
npx tsoa spec 

# Preview API docs (optional)
npx redocly preview-docs build/swagger.json

# Build updated HTML docs
npx redocly build-docs build/swagger.json --output ../docs/api-docs.html

Note: Run npm i first if setting up for the first time.

Developer tools

• The Movie Database (TMDB): The Movie Database
• TMDB API Reference: Getting started

Development progress

To track the development progress of this project and upcoming feature,s check out this project's board on GitHub.

Acknowledgments

Data provided by The Movie Database (TMDB).

License

This project is licensed under the GNU AFFERO GENERAL PUBLIC LICENSE. Refer to the LICENSE file for details.