Skip to content

Amineharrabi/Matchy

Repository files navigation

Matchy 3.0

watch the youtube video ! : https://www.youtube.com/watch?v=6qCYULbW1yI

(OPEN SOURCE)

A modern music discovery and playlist management app built with Expo and the Spotify API.

Features

  • Discover new music based on your favorite genres and moods
  • Create and manage Spotify playlists directly from the app
  • View detailed analytics about your music taste
  • Track your listening history
  • Beautiful, modern UI with dark theme
  • Secure authentication with Spotify
  • match with people with the same music taste as you

Tech Stack

Getting Started

  1. Clone the repository:
git clone https://github.com/yourusername/Matchy-2.0.git
cd Matchy-2.0
  1. Install dependencies:
npm install
  1. Create a .env file in the root directory with your Spotify API credentials:
EXPO_PUBLIC_SPOTIFY_CLIENT_ID=your_client_id
EXPO_PUBLIC_SPOTIFY_CLIENT_SECRET=your_client_secret
EXPO_PUBLIC_DEVELOPER_EMAIL=your_email
  1. Start the development server:
npm start
  1. Open the app in Expo Go or run on a simulator:
  • Press a for Android
  • Press i for iOS
  • Scan the QR code with Expo Go (Android) or Camera app (iOS)

Project Structure

  • /app - App screens and navigation
  • /components - Reusable UI components
  • /services - API and authentication services
  • /hooks - Custom React hooks
  • /types - TypeScript type definitions
  • /constants - App constants and configuration

Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

License

This project is licensed under the CC01 Licence- see the LICENSE file for details.

Acknowledgments

About

Matchy is a mobile app that helps you discover and share music with friends. It uses Spotify's API to provide personalized and fully control music recommendations and playlist management.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors