Data

Tools

Indexes

Applications

Experiments

Awesome

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

https://github.com/mirokrastanov/tv-kingdom

🎬📺🏰🎉TV Kingdom, where the magic of television meets the future: a modern, fully responsive, full-stack web application that unlocks a kingdom of limitless TV show data at your fingertips!
https://github.com/mirokrastanov/tv-kingdom

actor back-end css drama front-end html javascript js react reactjs responsive spa student tv tv-series tv-show web

Last synced: 14 days ago
JSON representation

🎬📺🏰🎉TV Kingdom, where the magic of television meets the future: a modern, fully responsive, full-stack web application that unlocks a kingdom of limitless TV show data at your fingertips!

Awesome Lists containing this project

README 

          
# TV-Kingdom

🎬📺🏰🎉TV Kingdom, where the magic of television meets the future: a modern, fully responsive, full-stack web application that unlocks a kingdom of limitless TV show data at your fingertips!





   game-image




#### Site is powered by: [TV MAZE](https://www.tvmaze.com)



## Disclaimer

- This is a non-commercial student project designed to showcase programming skills. I have only used it in a student environment @SoftUni.





## App Demo

#### The app was deployed using the Firebase Hosting service



- BACKUP: [In case main hosting is down](https://kingdom-71759.firebaseapp.com/)



#### Last updated - Dec 2023







# General App Overview

## Introduction

The website is an entertainment platform focused on TV shows. It provides users with a variety of features including browsing and searching for shows, viewing detailed information about shows, seasons, episodes, cast, crew, and actors. Users can also explore images related to shows and episodes. Additionally, the website offers user authentication, allowing registered users to personalize their experience by managing their profiles.



## Features

- `Infinite Scrolling` for Shows, Actors & Schedule pages.

- Unique Home Page `Show Cards Slider` supporting user interactions and resembling the Shuffle of a Deck of Cards. Available to both guests and users.

- Schedule page for tracking show timings.

- Detailed pages for Shows, Seasons, Episodes, Cast, Crew, and Actors.

- `User authentication` for personalized profiles. Users get an enhanced experience and full access to the app.

- Custom 404 Not Found page for handling invalid routes.

- `Light/Dark modes` - selection is remembered for each account.

- `Comments` for the following pages: Show Details, Actor Details, Episode Details.

- Overview of `latest comments` is also available on Users' profile page.

- `Profile image selection` from a preset of stock images (future update might also support custom image upload).

- `Dynamic search` available both from the nav bar and as a dedicated feature page.

- Dynamic switching between Shows & Actors results. Both available on the dedicated Search page.

- Dynamic navigation with animations and `Custom Tooltips`.

- `Responsive Design on All pages`. Mobile device views and mobile specific navigation with a show/hide button.

- `Custom scrollbars` with a smooth effect.

- The app also features a set of beautiful background images for user sign in & sign up pages, and also for the home page.

- And much more...



## Page Map

1. Home

   - Route: `/`

   - Element: ``



2. Schedule

   - Route: `/schedule`

   - Element: ``



3. Shows

   - Route: `/shows`

   - Element: ``

     - Show Details

       - Route: `/shows/:showId/details`

       - Element: ``

     - Show Seasons

       - Route: `/shows/:showId/seasons`

       - Element: ``

     - Show Season

       - Route: `/shows/:showId/seasons/:seasonId`

       - Element: ``

     - Show Episodes

       - Route: `/shows/:showId/episodes`

       - Element: ``

     - Show Cast

       - Route: `/shows/:showId/cast`

       - Element: ``

     - Show Crew

       - Route: `/shows/:showId/crew`

       - Element: ``

     - Show Images

       - Route: `/shows/:showId/images`

       - Element: ``



4. Episodes

   - Route: `/episodes/:episodeId/details`

   - Element: ``



5. Actors

   - Route: `/actors`

   - Element: ``

     - Actor Details

       - Route: `/actors/:actorId/details`

       - Element: ``



6. Search

   - Route: `/search`

   - Element: ``



7. User Profile

   - Route: `/user/profile`

   - Element: ``



8. User Sign-In

   - Route: `/user/sign-in`

   - Element: ``



9. User Sign-Up

   - Route: `/user/sign-up`

   - Element: ``



10. Not Found

    - Route: `*`

    - Element: ``







## Sneak Peak Images 

- Dashboard (User View)



- Actor Card, Show Card (with a custom animation that uncovers hidden extra content) & Custom tooltips



   game-image

   game-image

   game-image

   game-image




- Comments



   game-image




- Episodes



   game-image




- Images



   game-image




- Schedule



   game-image




- Search - Nav view & Dedicated page view



   game-image

   game-image




- Seasons



   game-image




- Home (Light Mode)



   game-image




- Home (Dark Mode)



   game-image




- Actors



   game-image




- Show Details



   game-image




- Episode Details



   game-image








## A lot more awaits you on the app. Thank You! 



- BACKUP: [In case main hosting is down](https://kingdom-71759.firebaseapp.com/)










# Technical Information



## Project Tools & Technologies used

### IDE

- [VS Code](https://code.visualstudio.com/)

### Extensions 

- [CSS Variable Autocomplete](https://marketplace.visualstudio.com/items?itemName=vunguyentuan.vscode-css-variables)

- [ES7+ React/Redux/React-Native snippets](https://marketplace.visualstudio.com/items?itemName=dsznajder.es7-react-js-snippets)

### Languages

- [JavaScript](https://developer.mozilla.org/en-US/docs/Web/JavaScript)

- [HTML](https://developer.mozilla.org/en-US/docs/Web/HTML)

- [CSS](https://developer.mozilla.org/en-US/docs/Web/CSS)

### Libraries

- [Swiper.js](https://swiperjs.com/)

- [React Feather](https://feathericons.com/)

- [React Router](https://reactrouter.com/en/main)

- [Vite](https://vitejs.dev/guide/)

### Fonts, Icons & Visual elements

- [Font Awesome Icons](https://fontawesome.com/)

- [Google Material Icons](https://fonts.google.com/icons?icon.set=Material+Symbols)

- [Font - Montserrat](https://fonts.google.com/specimen/Montserrat)







## Front End side 

### This SPA project was built using the React.js

- More information regarding React can be found in [this README](https://github.com/mirokrastanov/TV-Kingdom/blob/main/client/README.md) and in the [React Docs](https://react.dev/learn).







## Back End side

### Authentication 

- [Appwrite.io](https://cloud.appwrite.io/)

### Database 

- [Appwrite.io](https://cloud.appwrite.io/)

### Hosting 

- [Firebase](https://firebase.google.com/)

### Read more

- Read the details of this project's back end handling and challenges. [Here](https://github.com/mirokrastanov/TV-Kingdom/blob/main/server/README.md)



### Powered by 

- App Data provided by: [TV MAZE](https://www.tvmaze.com)