Skip to content

Nikhil-sha/Ripple

Repository files navigation

Ripple

Overview

Ripple is a music web app built using modern web technologies:

  • HTML5
  • CSS3 (Tailwind CSS)
  • JavaScript (React.js)

It leverages the Saavn.dev API for music streaming.

Repository

The source code for Ripple is available on GitHub:
🔗 Ripple Repository


ChangeLog

Version 2.7.0 (current)

Release Notes:

  • Minor improvement in APIs.
  • Major improvements in UI.

Version 2.6.0 (stable)

Release Notes:

  • Album page added.

Version 2.5.1

Release Notes:

  • lyrics support.

Version 2.5.0

Release Notes:

  • Improved UI.

Version 2.4.0

Release Notes:

  • Artist page added.

Version 2.3.0 (stable?

Release Notes:

  • Improved UI.
  • Suggestions according to saved tracks, on Home page.
  • Improved Haptic feedback.

Version 2.2.1

Release Notes:

  • New Search results limit option added in Settings.
  • Haptic feedback added.

Version 2.2.0

Release Notes:

  • New Quality Preference added.
  • New Settings section added.
  • Improved UI.

Version 2.1.3 (stable)

Release Notes:

  • Changed Home page layout.

Version 2.1.2

Release Notes:

  • Highlight current track in player.

Version 2.2.1 (Current - Stable)

Release Notes:

  • Added Search results limit option in Settings.
  • Integrated haptic feedback for better user experience.

Version 2.2.0

Release Notes:

  • Introduced Quality Preference setting.
  • Added a new Settings section.
  • Improved user interface (UI).

Version 2.1.3 (Stable)

Release Notes:

  • Updated Home page layout for better usability.

Version 2.1.2

Release Notes:

  • Current track highlighting added in the player.

Version 2.1.1

Release Notes:

  • Implemented Notification Center for updates.
  • Scroll to refresh feature disabled.

Version 2.1.0

Release Notes:

  • Users can play songs directly from the search page.
  • Users can save songs to Local Storage from both the search and details pages.
  • A Saved page has been added to access stored songs.

Version 2.0.0

Release Notes:

  • Implemented music search functionality.
  • Added detailed song pages with metadata.
  • Users can play songs from the details page.

Usage Guide

Searching for Music

  • Enter the song or artist name in the search bar.
  • Browse the search results and select a track.

Playing Songs

  • Click on a song from the search results or details page.
  • The player will load and start streaming the selected track.

Managing Saved Songs

  • Use the Save button to store a song in Local Storage.
  • Access saved songs from the Saved section.

Settings

  • Configure audio quality preferences.
  • Set a limit on search results for optimized performance.

API Integration

Ripple integrates with the Saavn.dev API to fetch music data.
Developers can refer to the official API documentation for further customization.


Futures In Progress

  • Playlist creation and management
  • Customizable themes and UI improvements

For any issues or feature requests, please submit an issue on GitHub. 🚀