FilmQuest is a single-page film discovery app that allows users to explore a wide range of films. This app will interact with TMDB API to fetch data about the films. It will display the details like plot, title, released year, director, poster etc. Users can search for films and see the related results. It will be a responsive app through laptop, tablet and mobile devices. The design of the app will be modern, dark-themed colour palette inspired by Letterboxd.
- Single-page application with DOM Manipulation.
- Interaction with TMDB API to fetch the data
- The app should show the loading state when fetching data
- Loading state during data fetching
- Error handling for API interactions
- Search functionality to find films and display detailed information (title, released year, plot, ratings etc.)
- Responsive design for various device sizes (laptop, tablet, mobile)
- Users can add films to their favorites and store them in local storage
- Displaying the popular films on Home page
You can check out a live demo of FilmQuest here: (https://sertanrdn.github.io/FilmQuest/#Home)
This demo allows you to experience the core features of the app, including film search, viewing film details, adding films to favorites, and more.
Follow these steps to run FilmQuest locally on your machine:
-
Clone this repository:
git clone https://github.com/yourusername/FilmQuest.git
-
Navigate to the project folder:
cd FilmQuest -
Open the index.html file in your browser: Simply double-click the index.html file or open it via your preferred browser. Alternatively, you can use a local server to run the app if you'd prefer to use any build tool or static server for a better local setup.
-
If you want to run the app with a build process, make sure you have Node.js installed. Then, run the following commands to install dependencies and start the app:
npm install npm start
This will start a local development server, and you can view the app by visiting http://localhost:3000 in your browser.