Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/vijethph/cinematics

A Spring Boot Application that displays basic information about movies.
https://github.com/vijethph/cinematics

bootstrap css hibernate html java javascript maven postgresql spring-boot supabase thymeleaf

Last synced: 11 days ago
JSON representation

A Spring Boot Application that displays basic information about movies.

Awesome Lists containing this project

README 

        


  

 Cinematics




Cinematics






[![Status](https://img.shields.io/badge/status-active-success.svg?style=flat-square&logo=java)]()

[![GitHub issues](https://img.shields.io/github/issues/vijethph/cinematics?style=flat-square)](https://github.com/vijethph/cinematics/issues)

[![Contributors](https://img.shields.io/github/contributors/vijethph/cinematics?style=flat-square)](https://github.com/vijethph/cinematics/graphs/contributors)

[![GitHub forks](https://img.shields.io/github/forks/vijethph/cinematics?style=flat-square)](https://github.com/vijethph/cinematics/network)

[![GitHub stars](https://img.shields.io/github/stars/vijethph/cinematics?color=yellow&style=flat-square)](https://github.com/vijethph/cinematics/stargazers)

[![GitHub Pull Requests](https://img.shields.io/github/issues-pr/vijethph/cinematics?color=purple&style=flat-square)](https://github.com/vijethph/cinematics/pulls)

[![GitHub license](https://img.shields.io/github/license/vijethph/cinematics?style=flat-square)](https://github.com/vijethph/cinematics/blob/master/LICENSE)

[![forthebadge](https://forthebadge.com/images/badges/made-with-java.svg)](https://forthebadge.com)

[![forthebadge](https://forthebadge.com/images/badges/powered-by-responsibility.svg)](https://forthebadge.com)

[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy)

[![Deploy to Render](https://render.com/images/deploy-to-render-button.svg)](https://render.com/deploy?repo=https://github.com/vijethph/cinematics)






---



 A Spring Boot Application which gives information about movies, and has a database of released movies.

    
 Made with Spring Boot, Thymeleaf and PostgreSQL




## :scroll: Table of Contents



- [Screenshots](#screenshots)

- [About](#about)

- [Getting Started](#getting_started)

- [Deployment](#deployment)

- [Usage](#usage)

- [Built Using](#built_using)

- [Authors](#authors)

- [Acknowledgments](#acknowledgement)



## :framed_picture: Screenshots 



![Home page](src/main/resources/static/assets/images/cinematicshomepage.jpg "Home Page")

![Movie Details Page](src/main/resources/static/assets/images/moviedetails.jpg "Movie Details Page")



## :information_source: About 



This is a Spring Boot application which stores a database of released movies. It uses Spring Boot Framework for overall handling, Thymeleaf template engine for displaying and retrieving variables, and PostgreSQL to store the collection of movies.



Users can search for their favourite movies, actors and directors based on name and can view more details about them.



## 🏁 Getting Started 



Follow these instructions in order to get a copy of the project up and running on your local machine for development and testing purposes. See [deployment](#deployment) for notes on how to deploy the project on as a live server.



### Prerequisites



Java runtime version 11 (JAVA SE 11), Apache Maven>=3.6 and PostgreSQL>=14.0 are required.



After installing, check their versions using these commands



```

java -version

mvn -v

```



### 🧱 Installing 



Clone this project and open this project in terminal.



```bash

cd cinematics

```

Replace the following variables in `src/main/resources/application.properties` file (sample values are given for Docker Compose):

```

spring.datasource.url=jdbc:postgresql://postgresdb:5432/cinematics?currentSchema=public&user=testcomposeuser&password=Test@123

spring.datasource.username=testcomposeuser

spring.datasource.password=Test@123

```

And run the project using following command and check the output at https://localhost:8080 in your browser.



```

mvn spring-boot:run

```



If it shows any errors then run the following command before executing the above command:



```

mvn package

```

or

```

mvn clean install

```



This app can also be run with Docker using `Dockerfile` and `docker-compose.yml` files as long as the above variables are replaced with suitable values.



## 🎈 Usage 



This application can be used by everyone if it is deployed using the steps in [deployment](#deployment). For usage by a single user, the following steps should be followed:



- After starting the server, and opening https://localhost:8080 your browser, the homepage of application website will be displayed. From there you can navigate to any sections as per your choice.

- Try using any of the search options provided and feel free to browse through the details given. For some of the search options, the results will be displayed at the bottom of the page.



## 🚀 Deployment 



The application can be deployed to Heroku so that everyone can access it through the internet. To do this you must have a Heroku account and a suitable plan. Simply click this badge to deploy the application to Heroku.



Now the project is deployed. It will show an output giving a website address like this:



```

deployed at

```



Ask your friends to open up the specified url and use the application.



## ⛏️ Built Using 



- [Spring Boot](https://spring.io/projects/spring-boot/) - Server Framework

- [Thymeleaf](https://www.thymeleaf.org/) - HTML Template Engine

- [PostgreSQL](https://www.postgresql.org) - Relational DBMS



## ✍️ Authors 



- [@vijethph](https://github.com/vijethph) - Idea & Full Development



See also the list of [contributors](https://github.com/vijethph/) who participated in this project.



## 🎉 Acknowledgements 



- Thanks to project sessions conducted by my college.

- Inspiration: Project Ideas for Spring Boot

- References: Spring Boot and Thymeleaf Documentations.