Skip to content

README.md

Latest commit

 

History

History
144 lines (109 loc) · 4.07 KB

README.md

File metadata and controls

144 lines (109 loc) · 4.07 KB

🎬 MovieMatchApp

MovieMatchApp Logo

Features • Getting Started • Installation • Contributing • Roadmap • License

🎯 About

MovieMatchApp is your go-to platform for discovering and sharing movies and TV shows with friends. Think Tinder meets IMDb – swipe through titles, match with friends who share your taste, and never miss out on great content again!

✨ Features

Current Features

  • 🔐 Secure Authentication - Firebase-powered user authentication
  • 👤 Profile Customization - Personalized streaming preferences and genre selection
  • 🎴 Interactive Swiping - Tinder-style card swiping for movies/shows
  • 📋 Smart Watchlists - Real-time updated lists of liked content
  • 👥 Social Features - Friend activity feed and matching system
  • 🎥 TMDB Integration - Rich, up-to-date movie and show information

🚧 Under Development

  • 💬 In-app chat system
  • 🎯 Advanced recommendation algorithm
  • 📱 Cross-platform streaming service integration

🚀 Getting Started

Prerequisites

  • Node.js (v14 or higher)
  • npm or yarn
  • Expo CLI
  • iOS/Android Simulator or physical device

Installation

  1. Clone the repository
git clone https://github.com/yourusername/MovieMatchApp.git
  1. Install dependencies
cd MovieMatchApp
npm install
  1. Set up environment variables
cp .env.example .env

Fill in your API keys and configuration values

  1. Start the development server
expo start
  1. Open the app on your simulator or physical device using the Expo Go app.
  • For iOS, press i in the terminal to open in the iOS simulator.
  • For Android, press a in the terminal to open in the Android emulator.
  • For physical devices, scan the QR code displayed in the terminal using the Expo Go app.
  1. Follow the on-screen instructions to test the app.

🤝 Contributing

I'm actively looking for contributors! Whether you're a developer, designer, or movie enthusiast, there are many ways to help:

Areas We Need Help With

  • Implementing chat functionality

  • Enhancing recommendation algorithm

  • UI/UX improvements

  • Adding more streaming service integrations

  • Writing tests

  • Documentation

How to Contribute

  1. Fork the repository

  2. Create your feature branch

git checkout -b feature/AmazingFeature

  1. Make your changes

  2. Commit your changes

git commit -m 'Add some AmazingFeature'
  1. Push to the branch
git push origin feature/AmazingFeature
  1. Open a Pull Request
git checkout -b feature/AmazingFeature
  1. Describe your changes and submit the pull request.

Check out our Contributing Guidelines for more details.

📄 License This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments TMDB for their comprehensive movie database

Our amazing contributors and supporters

Made with ❤️ by Enrique Barclay and the MovieMatchApp team