This project uses the TMDB (The Movie Database) API to display the newest movies and allow custom searches filtered by title and genre. Users also can explore a variety of movies, view details, and browse through specific categories.
Please note that in order to use this project you need to make a free account in TMDB to obtain a key and then make queries, this will be all explained below so don't worry.
As you won't be capable of using this unless you first make your account, we think it's a good idea to show you how the app is built.
This is the first thing you'll see when you run the app, the newest films.

If you click on them, you're being redirected to see more details of the film as you can see

Also, as you can see, you can add it to your favourites or to your watchlist
If it is already added in your watchlist or in your favourites...
You can also check the most trending actors of the moment
Click on them to see each actor's best movies!
This is only a sneak peek of what you can do with the app, if you want to see more you'll have to try it for yourself!
- View the most recent movies.
- View the trending actors right now and its movies.
- Filter movies by title and genre.
- Add movies to your watchlist or to your personal favourites.
- React Router
- TypeScript
- Vite: For fast development and packaging.
- Node.js installed on your PC.
- A TMDB account to get an API key.
-
Clone this repository:
git clone https://github.com/oligarc/React-Router-TMDB.git
-
Navigate to the project directory cd React-Router-TMDB
-
Install dependencies: npm install
-
Set up your TMDB API Key
- Sign up on TMDB
- Go to your account settings and get your API key.
- Add your API key to the appropriate file (in our case we made an .env file to store there the key, so...)
-
(Optional) Store the API Key in a .env file
Make sure you have the dotenv dependency installed!. Then, make a .env file at the root directory.
Follow this structure --> VITE_API_KEY=your_key
Then, in the .gitignore include this line --> .env
There you go!
-
(Optional) How to use the key if stored in .env
-
In the js, follow this again --> const API_KEY = import.meta.env.VITE_API_KEY
Then in the functions you won't have any problems
-
FAV AND WATCHLIST
-
That's all! Now use the npm run serve (instead of the traditional npm run dev) command and the app will be up and running!
-
Oliver:
-
Juan:
This project is licensed under the MIT License. See the LICENSE file for more details.


