Skip to content

CPNV-ES/AWA1_The_Vinyl

Repository files navigation


The Vinyl

Modern Beats, Retro Vibes.

About The Project

The Vinyl is a unique web app that lets users experience their favorite modern tracks on a retro vinyl player interface. By connecting to their premium Spotify account, users can enjoy the nostalgic aesthetic of vintage vinyl while listening to their curated albums and tracks.

Built With

Node Vue tailwind Spotify Web API Spotify WebPlayback API Vite

Getting Started

Development environment

Installation & running the project

  1. Clone the repo

    git clone https://github.com/CPNV-ES/AWA1_The_Vinyl.git
  2. Install NPM packages

    npm install
  3. Copy the .env.example file and rename it to .env. Fill in the required information. You'll need to create a Spotify Developer account and create a new app to get the required keys.

  4. Run the project

    npm run dev

Collaborate

Convention

Commit

The project uses Conventional Commits. The keywords used are: feat, fix, chore, refactor, test, docs. The commits are named with the following pattern: type: description eg.(feat: add awsome feature).

Workflow

The project uses Gitflow. The branches used are: main, develop, feature, release, hotfix. The branches are named with the following pattern: type/short-description eg.(feature/awsome-feature).

Versioning

The project uses SemVer. The versioning is done with the following pattern: major.minor.patch eg.(1.0.0).

Miscellaneous

External resources

Spotify

API and SDK

The project uses the Spotify Web API to log in and control the user's queue and playing track.

In the other hand, the Spotify Web Playback SDK is used to play the tracks on the web app and control the media control (play, pause, next, previous).

Further information can be found on our wiki.