Skip to content

Repository files navigation

TrackSpk

A platform for discussing and rating music tracks. TrackSpk allows users to share, rate, and discuss their favorite music with others.

Features

  • User account system with login/registration
  • Add and discover music tracks
  • Rate tracks based on multiple criteria:
    • Vibe Rating
    • Songwriting Rating
    • Lyrics Rating
    • Production Rating
  • Comment system for discussing tracks
  • Album art fetching from LastFM API
  • Real-time track ratings
  • Persistent data storage
  • API documentation included

Screenshots

Main Page

Main Page

Profile View

Profile Page

Track Creation

Track Created

Getting Started

Prerequisites

  • Node.js (Latest LTS version recommended)
  • npm (Comes with Node.js)

Installation

  1. Clone the repository:
git clone https://github.com/rileyhutton/TrackSpk.git
  1. Navigate to the project directory:
cd TrackSpk
  1. Install dependencies:
npm install
  1. Set up LastFM API key:
    • Replace INSERT API KEY HERE in app.js with your LastFM API key
    • You can get an API key from LastFM API

Running the Application

  1. Start the server:
npm start
  1. Open your browser and navigate to:
http://localhost:8080

Running Tests

The project includes a test suite built with Jest. To run the tests:

npm test

API Documentation

API documentation can be found in the api_docs folder. Open GettingStarted.html to view the complete API documentation.

Technology Stack

  • Backend:
    • Node.js
    • Express.js
  • Frontend:
    • HTML5
    • CSS3 (Bootstrap framework)
    • JavaScript
  • Testing:
    • Jest
    • ESLint
  • APIs:
    • LastFM API for album artwork

About

This project was developed as part of the Programming Black module at Durham University.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages