Skip to content

Repository files navigation

👾 Pixel Player 🎧

A lightweight, customized desktop music application styled with a flat candy Y2K palette, hard-edge retro shadows, and pixelated design layouts.

Built natively inside an Electron app shell shell wrapper driven by the Bun runtime and TanStack Start.


✨ Features

  • 🌸 Y2K Retro Theme: Flat candy pink and cream styling variables matching early-2000s desktop widgets.
  • ❤️ Custom Heart Slider Controls: Hand-rendered pixel artwork slider elements controlling layout tracks.
  • 🔀 Standalone Canvas Architecture: Disconnected from third-party generation constraints for fast execution.
  • 🏎️ Optimized Engine: Uses the Bun native JS runner to compile styling classes quickly.

🚀 Getting Started

Prerequisites

Make sure your development machine has the following dependency runtimes installed:

  • Bun: ^1.x
  • Node.js: ^22.12.0 (Active LTS)

Installation Loop

Clone your repository to your local workspace and initialize the asset blocks:

# Sync local dependencies
bun install

# Run the live hot-reloading development server
bun run dev

# In a separate terminal window, mount your desktop app wrapper
bun run electron

🔧 Project Architecture

  • /src — Core application layout components, state maps, and font configurations.
  • /electron — Desktop shell controller entry points, cache bypass handlers, and window metrics.
  • /src/styles.css — High-density Tailwind v4 candy palette layout metrics and keyframe utilities.

About

A lightweight Y2K desktop music player widget built with Bun, Electron, React, and TanStack Start.

Topics

Resources

Stars

Watchers

Forks

Contributors

Languages