Project based on shadcn/ui's music template.

This is a "Modern" Navidrome (or Subsonic) client built with Next.js and shadcn/ui. It creates a beautiful, responsive music streaming web application that connects to your Navidrome server, and fully able to self-host using docker!

• Real Music Streaming via Navidrome/Subsonic API
• Modern UI with shadcn/ui components
• Dynamic Album Artwork from your music library
• Favorites - Star albums, artists, and songs
• Search - Find music across your entire library
• Audio Player with queue management
• Scrobbling - Track your listening history
• Playlist Management - Create and manage playlists
• Caching - Cache/Offline save your server

• Navidrome server running
• Node.js 18+

1. Clone and install the required dependencies

git clone https://github.com/sillyangel/project-still.git

cd project-still/
pnpm install



# or npm
npm installl

First, copy the example environment file:

cp .env.example .env

Next, open the new .env file and update it with your Navidrome server credentials:

NEXT_PUBLIC_NAVIDROME_URL=http://localhost:4533

NEXT_PUBLIC_NAVIDROME_USERNAME=your_username

NEXT_PUBLIC_NAVIDROME_PASSWORD=your_password

NEXT_PUBLIC_POSTHOG_KEY=phc_XXXXXXXXXXXXXXXXXX

NEXT_PUBLIC_POSTHOG_HOST=https://us.i.posthog.com

Tip: If you don’t have your own Navidrome server yet, you can use the public demo credentials:

NEXT_PUBLIC_NAVIDROME_URL=https://demo.navidrome.org

NEXT_PUBLIC_NAVIDROME_USERNAME=demo

NEXT_PUBLIC_NAVIDROME_PASSWORD=demo

3. Run the development server

pnpm dev


# or npm

npm run dev
v

Open http://localhost:40625 in your browser.

For easy deployment using Docker:

# Run using pre-built image (app will prompt for Navidrome configuration)
docker run -p 3000:3000 sillyangel/mice:latest



# Or build locally
docker build -t mice  .
docker run -p 3000:3000 micee

# Copy environment template and configure
cp .env.docker .env

# Edit .env with your settings (optional - app can prompt)
docker-compose up -dd

docker run -p 3000:3000 \
  -e NEXT_PUBLIC_NAVIDROME_URL=http://your-navidrome-server:4533 \
  -e NEXT_PUBLIC_NAVIDROME_USERNAME=your_username \
  -e NEXT_PUBLIC_NAVIDROME_PASSWORD=your_password \
  sillyangel/mice:latesttest

For detailed Docker configuration, environment variables, troubleshooting, and advanced setups, see DOCKER.md

• Frontend: Next.js 15, React 19, TypeScript
• UI: shadcn/ui, Tailwind CSS, Radix UI
• Backend: Navidrome (Subsonic API compatible)
• Audio: Web Audio API with streaming
• State: React Context for global state management

This project is licensed under the MIT License.

• shadcn/ui for the beautiful UI components
• Navidrome for the amazing music server
• Subsonic API for the API specification