Your weekly music club. Share songs, vote favorites, crown the DJ.
Aux is a weekly music club for friend groups. Create a group, share a link, and every week each member drops their favorite tracks. Everyone rates the songs (0-5 stars with half-star precision), and a leaderboard crowns the best DJ. Works cross-platform — paste a Spotify or YouTube Music link and Aux resolves it for every platform.
No signup required. Share a link and you're in.
- Framework: Astro 5 + React islands
- Styling: Tailwind CSS 4 + CSS custom properties
- Data: Supabase (PostgreSQL + client-side SDK)
- Links API: Odesli (song.link) for cross-platform resolution
- Deploy: Netlify
- Testing: Vitest
- i18n: English (default) + Spanish
- Node.js >= 20
- pnpm
- A Supabase project (free tier works)
pnpm installCopy .env.example and fill in your Supabase credentials:
cp .env.example .env| Variable | Description |
|---|---|
PUBLIC_SUPABASE_URL |
Your Supabase project URL |
PUBLIC_SUPABASE_ANON_KEY |
Your Supabase anonymous key |
Run the SQL in supabase/schema.sql in your Supabase SQL editor to create the tables, indexes, and RLS policies.
pnpm dev| Command | Description |
|---|---|
pnpm dev |
Start development server |
pnpm build |
Production build |
pnpm preview |
Preview production build |
pnpm lint |
ESLint + Astro check |
pnpm test |
Run tests |
pnpm format |
Format with Prettier |
- Create a group — Pick a name, get a shareable link
- Share the link — Friends join with just a name, no signup
- Drop tracks — Paste Spotify or YouTube links each round
- Vote & compete — Rate songs 0-5 stars, climb the leaderboard
Rounds are automatic (Monday-Sunday UTC). A new round starts each week.
MIT — see LICENSE