Introduction • Key Features • Installation • Usage • Contributing • Author • License
To finalize my studies at Holberton School, I created FearSeer!
FearSeer (fear + seer) :
(fear) a distressing emotion aroused by impending danger, evil, pain, etc., whether the threat is real or imagined; the feeling or condition of being afraid.
(seer) a person who prophesies future events; prophet:
FearSeer is a Java Spring Boot web application for horror movies fans. As you might have understood by now FearSeer is a fun play on the words fear and seer.
It is a place where friends can bet on what is gonna happen in a horror movie by answering a quick quiz. Once the user finish their film, they can choose to see the answers to the quiz and their scores. This way a user will be able to find out if they truly know horror movies to the point of prediction.
The good news: you don't have to be a horror fanatic to have fun. Anyone can register and play the quiz. On a movie night with friends or by yourself, it doesn't matter. Good luck!
As previously stated, to access the Homepage a user will first have to register. Here is a preview of the registration form:
Once a user registers, they will be added to the database. Now they are able to login and access the Homepage.
The Homepage uses the TMDB API to show the popular horror movies of the moment. There is also the possibility to search for a movie in particular with the search bar.
Here come the main feature: the Quiz. User are able to click directly on the button below the posters to take the quiz. A simple ten questions that will tell you if you can predict the future of the characters.
The last functionnality added to Fearseer is the user profile! Now users can have their own profile with a bio and profile picture. On top of that, users can movies in the following lists: favorites, movies to watch later, and movies already seen. As such, they will be able to keep track of their horror movies watchlist easily by simply checking their profile where they will be shown.
Last but not least, FearSeer uses Spring Security in order to be more protected. By default, Spring Boot Security enables many security best practices (like CSRF protection, strong password encoding, and HTTPS enforcement). In addition, the registered users' passwords are encrypted in the database. All to make FearSeer a secure app!
FearSeer has not yet been deployed but here is how to install it locally.
If the requierements are met you can now clone this repository:
$ git clone https://github.com/mxnctblt/FearSeer.git
With Mysql create a FearSeer database:
$ CREATE DATABASE fearseer;
Once it is created you will need to connect it to the project. To do so, go to application.yml and put your mysql password in front of password:
spring:
database:
password:
IntelliJ is a code editor for Java. It simplify the production and you will simply need to go to the file DemoApplication.java and from there you will be able to use the button on the top to run FearSeer. Don't forget to check if all depedencies (in pom.xml) are downloaded.
Run the following command in the project directory:
$ mvn clean install
After the project is packaged, you can run it using the java -jar command.
$ java -jar demo-0.0.1-SNAPSHOT.jar.jar
If you don’t want to package the app and just want to run it from the source:
$ mvn spring-boot:run
Now that the server is running go to the website url that you just installed locally.
This web application uses the following open source packages:
- Java 17+
- MySQL 8+
- Maven
- MDB5
- Spring Boot
Maxence Thibault
github: @mxnctblt linkedin: Maxence Thibault
© 2024 FearSeer, All Rights Reserved.