Skip to content

About

an open source library for lyrics, can be easily integrated with spotify for real time synced lyrics.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

🎧 blackApple — A Community-Powered Lyrics Library

blackApple is a modern, full-stack lyrics platform that integrates directly with Spotify to deliver a seamless, real-time lyrics experience. It allows listeners to view, contribute, and manage song lyrics while staying connected to what they’re currently playing.

🌐 Live App: https://blackappple.vercel.app 👨‍💻 Developer Portfolio: https://kartikeshpachkawade.vercel.app


✨ Vision

Music is universal, but lyrics availability is fragmented, inconsistent, and often locked behind closed ecosystems.

blackApple solves this by creating an open, community-driven lyrics infrastructure where:

  • Users can contribute lyrics
  • Lyrics sync with real Spotify listening
  • The community builds the library together

This is not just a project — it's the foundation of a scalable lyrics ecosystem.


🚀 Core Use Cases

🎵 Real-Time Spotify Lyrics Integration

blackApple connects to your Spotify account and:

  • Detects currently playing song
  • Shows lyrics availability instantly
  • Allows quick access to lyrics

This creates a frictionless lyrics experience.


✍️ Community Lyrics Contribution

If lyrics are missing:

  • Users can contribute lyrics
  • Expand the global lyrics database
  • Help other listeners

This transforms passive listeners into active contributors.


👤 Personal Dashboard

Authenticated users can:

  • Access their profile
  • Contribute lyrics
  • Manage song interactions

Encouraging ownership and participation.


🌍 Open Lyrics Infrastructure

Unlike closed platforms, blackApple promotes:

  • Open access
  • Community-driven growth
  • Scalable architecture

Positioning itself as a future lyrics backbone.


🧠 Technical Highlights

⚡ Modern Full-Stack Architecture

Frontend

  • Next.js 15 (App Router)
  • TypeScript
  • Tailwind CSS
  • React Hook Form
  • Zod

Backend

  • Next.js API Routes
  • NextAuth.js Authentication
  • Spotify Web API Integration

Deployment

  • Vercel Edge Network

🔐 Secure Authentication

  • Spotify OAuth
  • JWT sessions
  • Protected routes via middleware
  • Production-grade auth flow

🎯 Real-Time Spotify Sync

Features include:

  • Current song detection
  • Live progress tracking
  • Lyrics availability detection

🎨 Modern UI

  • Spotify-inspired design
  • Responsive layout
  • Clean typography
  • Smooth UX

🏗️ Architecture

User
 ↓
Next.js Frontend
 ↓
NextAuth Authentication
 ↓
Spotify API
 ↓
Lyrics API
 ↓
Database

📂 Project Structure

app/
components/
context/
hooks/
lib/
schemas/
store/
middleware.ts

🌟 Why This Project Matters

blackApple demonstrates:

  • Real-world API integration
  • Authentication systems
  • Scalable architecture
  • Production deployment
  • Community-driven design thinking

This is a production-grade portfolio project, not just a demo.


🧑‍💻 Author

Kartikesh Pachkawade

Full Stack Developer passionate about building meaningful products.

Portfolio:

https://kartikeshpachkawade.vercel.app


🔮 Future Roadmap

  • Synced lyrics
  • Public lyrics API
  • Contribution system
  • Playlist lyrics
  • Mobile version

⭐ Support

If you like this project:

  • Star the repository
  • Share it
  • Connect with me

Portfolio:

https://kartikeshpachkawade.vercel.app


📜 License

This project is open source and available under the MIT License.


🎵 blackApple

Building the open lyrics future.

About

an open source library for lyrics, can be easily integrated with spotify for real time synced lyrics.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages