Aroha Music
A minimalist web audio platform and streaming interface built with React, TypeScript, and the Web Audio API, designed around editorial typography and calm pacing.
Overview
Contemporary streaming platforms are saturated with algorithmic carousels, intrusive banner promotions, dynamic social feeds, and telemetry trackers. The act of listening to music—and engaging with cover art, liner notes, and track progression—is often obscured by engagement-maximizing interface clutter.
Aroha Music was designed as an intentional counterweight: a web audio player that emphasizes quiet editorial layout, high-contrast typography, and a distraction-free listening environment.
Audio Engine & Playback Architecture
The player architecture separates audio decoding and buffer management from React component render lifecycles:
-
Web Audio Pipeline: Uses the native HTML5 Audio element paired with a Web Audio API
AudioContextnode graph, enabling accurate gain control, dynamic frequency analysis, and smooth gapless crossfades. - State-Preserving Audio Session: Playback state, track position, and active queue indices are maintained in a lightweight custom store, ensuring continuous audio playback during route transitions.
- Keyboard Accessibility: Complete keyboard transport controls: Space for toggle play/pause, ← / → for seeking 5 seconds, M for mute toggle, and N / P for track skip.
Editorial Design & Craft
The visual language borrows from vintage print journals and audio sleeve design:
- Serif & Monospace Balance: Album titles rendered in expressive serif typography, balanced against precise monospace track times, bitrates, and catalog coordinates.
- Persistent Bottom Rail: A restrained playback bar pinned to the viewport bottom with minimal scrub track, volume slider, and track metadata.
- Responsive Geometry: Seamless transition from broad multi-column editorial layouts on desktop to a compact, gesture-friendly bottom sheet on mobile devices.
Technical Specifications
| Framework | React 18 with TypeScript |
|---|---|
| Audio Processing | HTML5 Audio + Web Audio API AudioContext |
| Styling | Tailwind CSS + Scoped CSS Custom Properties |
| Motion | Framer Motion (Reduced-motion compliant) |
| License | MIT License |