Skip to content

ChethanNazre/cine-phile

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎬 Cine-Phile

Cine-Phile is a futuristic, high-performance full-stack MERN (MongoDB, Express.js, React, Node.js) movie web application that brings the cinematic universe to your fingertips. Explore rich movie metadata, search intuitively, rate like a critic, and build your ultimate digital watchlist.

GitHub Repo: https://github.com/ChethanNazre/cine-phile

“Lights, camera, action!”


🚀 Key Features

  • 🎥 Browse a vast, dynamic movie collection powered by movie APIs
  • 🔍 Fuzzy search by title, genre, language, or rating
  • ⭐ Real-time rating, reviews, and interactive movie cards
  • ❤️ Persistent personalized watchlist per user
  • 🔐 JWT-secured authentication and protected routes
  • 🛠️ Admin Dashboard to manage users, movies, and reviews
  • 📡 Real-time states: loaders, skeleton UIs, error boundaries
  • 🚀 Optimized performance with lazy loading and code splitting
  • 🧠 Scalable, modular, developer-friendly architecture

These features combine to deliver a fast, immersive, and modern cinematic web experience across devices.


🛠️ Tech Stack

LayerTechnology
FrontendReact.js, Tailwind CSS, Axios
BackendNode.js, Express.js
DatabaseMongoDB Atlas
AuthenticationJWT, Bcrypt
UtilitiesReact Router, Context API, Toastify
DeploymentVercel (Client), Render (API)

The chosen stack ensures performance, scalability, and maintainability for both developers and users.


🧰 Getting Started

Get the application running locally with the following steps:

🔃 Clone the Repository

git clone https://github.com/ChethanNazre/cine-phile.git
cd cine-phile

⚙️ Backend Setup

cd server
npm install
touch .env
# Add MongoDB URI and JWT secret in .env
npm run dev

This launches the Express server and connects it to MongoDB.

Sample .env file for backend

PORT=5000
MONGODB_URI=your_mongodb_connection_string
JWT_SECRET=your_super_secret_key

🎨 Frontend Setup

cd client
npm install
npm start

Run the React development server and open the app in your browser.

The app should now be live at http://localhost:3000
The backend runs at http://localhost:5000

🧪 Folder Structure

cine-phile/
├── client/           # React frontend
│   ├── src/
│   └── public/
├── server/           # Express backend
│   ├── routes/
│   ├── models/
│   └── controllers/
├── README.md
└── .gitignore

This modular layout separates concerns cleanly and supports scalability and maintenance.


📸 Demo

Here are some screenshots showcasing the Cine-Phile application:

Home Page

Home Page

Movies Section

Movies Section

Movie Details Page

Movie Details Page


🤝 Contributing

We welcome community contributions to improve Cine-Phile in every way possible—from UI/UX improvements and performance tweaks to feature additions and documen

We welcome community contributions!

  1. 🍴 Fork the repository
  2. 🛠️ Create your feature branch: git checkout -b feature/YourFeature
  3. ✅ Commit your changes: git commit -m 'Add amazing feature'
  4. 📤 Push the branch: git push origin feature/YourFeature
  5. 🔁 Open a Pull Request

Feel free to submit improvements in UI, bug fixes, documentation, or performance enhancements.


📄 License

This project is licensed under the MIT License.

You are free to use, modify, and distribute this project with appropriate attribution.

See the LICENSE file for more details.


💬 Connect With Me

Want to collaborate, hire, or geek out over movies and tech? Reach out! 🎬⚙️


Built with ⚡ and 🎬 by Chethan Nazre S.

About

A cinematic MERN web app to explore, rate, and manage your favorite movies with a futuristic UI.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors