BandFish

Bandfish is a conceptual spin off of BandCamp done by Joe Rashid. This project incorporates my favorite aspects of the BandCamp website, and includes in-depth feature emulation of its real-life counterpart. Users can explore an expansive list of albums, with details pages for each featuring artist information, reviews and tracks that can be freely streamed (FOR DEMONSTRATIVE PURPOSES ONLY). The application supports user-created content, allowing members to upload their own albums, podcasts, and songs or episodes. They can read and write reviews, leaving feedback for both artists and future customers. With an intuitive interface, users can signup and make their profile page their own with avatars and banners, customize their albums/podcasts or change track information, and place orders for other artists' content directly through the application. The service aims to streamline the digital audio marketplace, ensuring an enjoyable and thoughtful experience for all users.

Summary

Users can browse the website to find an album or a podcast they enjoy, and stream the tracks from that group for their enjoyment. Upon signing up, a user can choose a profile picture avatar for themselves, as well as a banner for their profile's page.

- ℹ️: Podcasts are treated like an album, albeit with a larger collection of tracks, the same way that Spotify or iTunes classify Podcasts.

Users can "shop" for albums or podcasts, and add them to their cart. They can complete a simplified checkout process. Users can add podcasts or albums to their wishlist from the details page of that track group.
Bandfish supports user-created content as well, allowing artists to publish their work and host their albums on the site.
Users can also review other artists' content, leaving feedback for new customers or the artist themselves

Images from development :)

Database Schema

Landing Page Wireframe

Example Product Details Wireframe

Example Profile page and Collection

Example Profile page and Wishlist

Uploading media wireframe

Live Link

https://bandfish.onrender.com

Connect with the creator!

Joe Rashid on LinkedIn

Tech Stack

Frameworks and Libraries

Database:

Hosting:

Wiki

View the wiki's table of contents here

Endpoints

Log In User

Method: POST
URL: /api/auth/login

Body:

{
  "email": "[email protected]",
  "password": "password123"
}

Successful Response:

{
  "email": "[email protected]",
  "firstname": "Joe",
  "lastname": "Mama",
  "id": 3,
  "role": "User",
  "username": "joemama",
  "profile_banner": "https://bandfishbucket.s3.amazonaws.com/indianajonesbanner.jpg",
  "profile_pic": "https://bandfishbucket.s3.amazonaws.com/1c69f339e921465fb528ef78a5f87e76.jpg",
  "wishlists": [{"id": 1, "product": {"album_art": "https://i.scdn.co/image/ab67616d0000b27361b7e027205d656d5b14b473", "artist_id": 5, "genre": "Ska", "id": 11, "name": "Feel Like That (feat. Bradley Nowell)", "price": "4.99", "type": "Single"  } }]

Albums

Create an Album

Method: POST
URL: /api/albums/new

Body:

{  
"album_art": "https://images.squarespace-cdn.com/content/v1/58d952abbf629acc7be750e4/5c5cb10b-30de-4b4c-ad43-b44bfaa657a6/lpotl+text+only+logo.jpg?format=1500w",
"artist": "The Last Podcast Network",
"artist-pfp": "https://bandfishbucket.s3.amazonaws.com/lpn.jpg",
"artist_id": 6,
"genre": "True Crime/Comedy",
"id": 1,
"name": "The Last Podcast on the Left",
"price": "5.99",
"type": "Podcast"
}

Successful Response:

{
"album_art": "https://images.squarespace-cdn.com/content/v1/58d952abbf629acc7be750e4/5c5cb10b-30de-4b4c-ad43-b44bfaa657a6/lpotl+text+only+logo.jpg?format=1500w",
"artist": "The Last Podcast Network",
"artist_id": 6,
"artist_pfp": "https://bandfishbucket.s3.amazonaws.com/lpn.jpg",
"genre": "True Crime/Comedy",
"id": 1,
"name": "The Last Podcast on the Left",
"price": "5.99",
"reviews": [],
"tracks": [],
"type": "Podcast",
"wishlists": []
}

View all Albums and Podcasts

Method: GET
URL: /api/albums/all
Body: none
Successful Response:

There are many more albums and podcasts but for the truncation of this document, the general structure of this response is just tens of more albums and podcasts in objects in this array

 {
  "albums_and_podcasts": [
 {
   "album_art": "https://images.squarespace-cdn.com/content/v1/58d952abbf629acc7be750e4/5c5cb10b-30de-4b4c-ad43-b44bfaa657a6/lpotl+text+only+logo.jpg?format=1500w",
   "artist": "The Last Podcast Network",
   "artist-pfp": "https://bandfishbucket.s3.amazonaws.com/lpn.jpg",
   "artist_id": 6,
   "genre": "True Crime/Comedy",
   "id": 1,
   "name": "The Last Podcast on the Left",
   "price": "5.99",
   "type": "Podcast"
 },
 ]
 }

View an individual Album/Podcast

Method: GET
URL: /api/albums/:albumId
Body: none

Successful Response:

{
"album_art": "https://images.squarespace-cdn.com/content/v1/58d952abbf629acc7be750e4/5c5cb10b-30de-4b4c-ad43-b44bfaa657a6/lpotl+text+only+logo.jpg?format=1500w",
"artist": "The Last Podcast Network",
"artist_id": 6,
"artist_pfp": "https://bandfishbucket.s3.amazonaws.com/lpn.jpg",
"genre": "True Crime/Comedy",
"id": 1,
"name": "The Last Podcast on the Left",
"price": "5.99",
"reviews": [
  {
    "body": "This podcast has been my absolute favorite for going on 6 years. Was better with Ben Kissel though.",
    "id": 1,
    "item_id": 1,
    "title": "I LOVE THIS POD",
    "user": "joemama",
    "user_id": 11,
    "user_pfp": "https://avatars.githubusercontent.com/u/148486236?v=4"
  }
],
"tracks": [
  {
    "album_id": 1,
    "artist_id": 6,
    "duration": "1:29:44",
    "id": 1,
    "source": "https://bandfishbucket.s3.amazonaws.com/Episode+331_+The+Donner+Party+Part+I.mp3",
    "title": "Episode 331: The Donner Party Part I - Salt of the Earth"
  },
  {
    "album_id": 1,
    "artist_id": 6,
    "duration": "1:48:24",
    "id": 2,
    "source": "https://bandfishbucket.s3.amazonaws.com/Episode+332_+The+Donner+Party+Part+I.mp3",
    "title": "Episode 332: The Donner Party Part II - The Forlorn Hope"
  }
],
"type": "Podcast",
"wishlists": []
}

Update an Album

Method: PUT
URL: /api/albums/:albumId

Body:

{  
"album_art": "https://images.squarespace-cdn.com/content/v1/58d952abbf629acc7be750e4/5c5cb10b-30de-4b4c-ad43-b44bfaa657a6/lpotl+text+only+logo.jpg?format=1500w",
"artist": "The Last Podcast Network",
"artist-pfp": "https://bandfishbucket.s3.amazonaws.com/lpn.jpg",
"artist_id": 6,
"genre": "UPDATED",
"id": 1,
"name": "The UPDATED Last Podcast on the Left",
"price": "7.99",
"type": "Podcast"
}

Successful Reponse:

{
"album_art": "https://images.squarespace-cdn.com/content/v1/58d952abbf629acc7be750e4/5c5cb10b-30de-4b4c-ad43-b44bfaa657a6/lpotl+text+only+logo.jpg?format=1500w",
"artist": "The Last Podcast Network",
"artist_id": 6,
"artist_pfp": "https://bandfishbucket.s3.amazonaws.com/lpn.jpg",
"genre": "UPDATED",
"id": 1,
"name": "The UPDATED Last Podcast on the Left",
"price": "7.99",
"reviews": [],
"tracks": [],
"type": "Podcast",
"wishlists": []
}

Delete an album

Method: DELETE
URL: /api/albums/:albumId
Body: none

Successful Response:

  {
    "message": "Successfully deleted the album"
  }

Tracks

Create a track

Method: POST
URL: /api/albums/:albumId/tracks/new

Body:

{
"title": "What I Got (Reprise)",
"source": "https://bandfishbucket.s3.amazonaws.com/SublimeWhat+I+Got+Reprise.mp3"
}

Successful Response:

  {
   "album_id": 10,
   "artist_id": 5,
   "id": 33,
   "source": "https://bandfishbucket.s3.amazonaws.com/SublimeWhat+I+Got+Reprise.mp3",
   "title": "What I Got (Reprise)"    
  }

Update a Track

Method: PUT,
URL: `/api/albums/:albumId/tracks/

Body:

  {
    "title": "What I Got (Reprise) UPDATED",
    "source": "https://sampleurlforupdatedtrack.net/bababooey"
  }

Successful Response:

 {
 "album_id": 10,
 "artist_id": 5,
 "id": 33,
 "source": "https://sampleurlforupdatedtrack.net/bababooey",
 "title": "What I Got (Reprise) UPDATED"
 }

Delete a track

Method: DELETE,
URL: /api/albums/:albumId/tracks/:trackId
Body: none
Successful Response:

  { "message": "Successfully deleted song" }

Reviews

Create a Review

Method: POST
URL: /api/albums/:albumId/reviews/new
Body:

{
 "title": "A review title",
 "body": "The body for the review"
}

Successful Response:

 {
  "user_id": 5,
  "item_id": 2,
  "id": 2,
  "title": "A review title",
  "body": "The body for the review"
 }

Update a Review

Method: PUT
URL: /api/albums/:albumId/reviews/:reviewId

Body:

  {
    "title": "An updated review title",
    "body": "The UPDATED body for the review"
  }

Successful Response:

{
    "user_id": 5,
    "item_id": 2,
    "id": 2,
    "title": "An updated review title",
    "body": "The UPDATED body for the review"
}

Delete a Review

Method: DELETE,
URL: /api/albums/:albumId/reviews/::reviewId
Body: none

Successful Response:

{ "message": "Successfully deleted the review" }

Name		Name	Last commit message	Last commit date
Latest commit History 140 Commits
app		app
instance		instance
migrations		migrations
react-vite		react-vite
.dockerignore		.dockerignore
.env.example		.env.example
.flaskenv		.flaskenv
.gitignore		.gitignore
Dockerfile		Dockerfile
Pipfile		Pipfile
Pipfile.lock		Pipfile.lock
README.md		README.md
requirements.txt		requirements.txt
setup.md		setup.md

poedude5229/BandFish

Folders and files

Latest commit

History

Repository files navigation

BandFish

Table of Contents

Summary

Images from development :)

Database Schema

Landing Page Wireframe

Example Product Details Wireframe

Example Profile page and Collection

Example Profile page and Wishlist

Uploading media wireframe

Live Link

Connect with the creator!

Tech Stack

Frameworks and Libraries

Database:

Hosting:

Wiki

Endpoints

Log In User

Albums

Create an Album

View all Albums and Podcasts

View an individual Album/Podcast

Update an Album

Delete an album

Tracks

Create a track

Update a Track

Delete a track

Reviews

Create a Review

Update a Review

Delete a Review

About

Resources

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages