Lightning

A modern music streaming app built with Flutter and Firebase.

Quick Start

# Install dependencies
flutter pub get

# Run the app
flutter run

Setup Firebase

1. Create Firebase project at console.firebase.google.com
2. Add Android/iOS apps to your project
3. Download config files:
   • google-services.json → /android/app/
   • GoogleService-Info.plist → /ios/Runner/
4. Enable services:
   • Authentication (Email/Password)
   • Firestore Database

📁 Project Structure

lib/
├── 📁 presentation/          # UI Layer
│   ├── auth/                # Authentication screens
│   ├── home/                # Main app screens
│   ├── intro/               # Onboarding
│   ├── song_player/         # Music player
│   └── splash/              # Splash screen
│
├── 📁 domain/               # Business Logic Layer
│   ├── entities/            # Business objects
│   ├── usecases/            # Application logic
│   └── repository/          # Abstract interfaces
│
├── 📁 data/                 # Data Layer
│   ├── models/              # Data models
│   ├── repository/          # Concrete implementations
│   └── sources/             # Data sources (Firebase)
│
├── 📁 core/                 # Core Layer
│   ├── configs/             # App configuration
│   └── usecase/             # Base use case
│
└── 📁 common/               # Shared Resources
    ├── widgets/             # Reusable widgets
    └── helpers/             # Helper functions

🔗 Key Files

File	Purpose
main.dart	App entry point
service_locator.dart	Dependency injection setup
pubspec.yaml	Dependencies & assets

📦 Tech Stack

Layer	Technology	Purpose
Framework		Cross-platform UI
Language		App logic
Backend		Authentication & Database
State		State management
Audio	just_audio	Music playback
DI	get_it	Dependency injection

⚙️ Features

• ✅ User Authentication (Firebase Auth)
• ✅ Music Streaming & Playback
• ✅ Playlist Management
• ✅ Dark/Light Theme
• ✅ Music Recognition
• ✅ Blog Integration

🛠️ Development

# Run in debug mode
flutter run

# Build for production
flutter build apk --release
flutter build ios --release

📱 Screens

1. Splash → Get Started → Auth → Choose Theme → Home
2. Home → Browse songs, playlists, blogs
3. Song Player → Full playback controls

---

Run flutter run and enjoy the music!