Vinyl Release Generator

This Val Town project generates fake but plausible vinyl record releases with a single click. Each generated release includes:

  • Artist name
  • Album title
  • Genre tags (3-5 tags)
  • Release year (between 1955 and 2023)
  • Record label
  • A brief but interesting backstory about the album

Project Structure

  • /vinyl-generator-api.ts - HTTP endpoint that provides random vinyl release data
  • /vinyl-ui.ts - Frontend interface with a button to trigger generation

How It Works

  1. When the "Generate Vinyl Release" button is clicked, the UI makes a request to the API
  2. The API selects a random vinyl release from a curated collection of fictional releases
  3. The data is returned to the UI and displayed in a visually appealing format

Features

  • Instant Generation: Get a new vinyl release with a single click
  • Detailed Information: Each release includes artist, album, genres, year, label, and backstory
  • Visual Appeal: Animated vinyl record and attractive display of information
  • Error Handling: Robust error handling with clear user feedback
  • Mobile-Friendly: Responsive design works on all device sizes

Technologies Used

  • Twind (Tailwind CSS in JS) for styling
  • Vanilla JavaScript for the frontend functionality
  • Custom-designed vinyl record animation

Usage

Simply visit the UI endpoint and click the "Generate Vinyl Release" button to get a new vinyl release.

UI URL: https://vinyl-ui.web.val.run API URL: https://vinyl-generator-api.web.val.run