Experience true randomness in your music. Break free from algorithmic bubbles with mathematically pure shuffle using the Fisher-Yates algorithm.

• True Random Shuffle: Uses cryptographically secure randomness with the Fisher-Yates algorithm
• Spotify Integration: Connect with your Spotify account to access playlists and liked songs
• Cross-Platform: Built with Expo and React Native for iOS, Android, and Web
• Modern UI: Beautiful, dark-themed interface optimized for music discovery

1. Clone the repository

   git clone https://github.com/vuciv/true-random-shuffle.git
   cd true-random-shuffle

2. Install dependencies

   npm install

3. Configure Spotify API

   • Create a Spotify app at Spotify Developer Dashboard
   • Create a .env file in the root directory:

     EXPO_PUBLIC_SPOTIFY_CLIENT_ID=your_spotify_client_id_here
     

   • Add redirect URIs to your Spotify app:
     • For development: trueshuffle://redirect
     • For web: https://yourdomain.com/redirect

4. Run the app

   npm run dev

The app can be deployed to various platforms:

• Web: Use npm run build:web to build for web deployment
• Mobile: Use Expo Application Services (EAS) for mobile app builds
• Netlify: Use the included deploy.sh script for web deployment

• Expo - Cross-platform development framework
• React Native - Mobile app framework
• TypeScript - Type-safe JavaScript
• Spotify Web API - Music streaming integration
• React Query - Data fetching and caching

This project is open source and available under the MIT License.

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.