NeonWave is a complete, production-ready React Native music streaming application built with Expo SDK 55 and the latest React Native 0.83. It features a sleek, premium dark UI with SoundCloud integration for music discovery, search, and streaming.

Perfect for entrepreneurs and developers looking to launch a music app quickly — just customize the branding, connect your audio source, and publish to the App Store and Google Play.

WHAT'S INCLUDED:
• Full source code (TypeScript)
• 5 main screens: Home, Discover, Search, Liked Songs, Library
• Full-featured music player with background playback
• User authentication system (local SQLite)
• Playlist management
• Offline caching

PLAYER FEATURES:
• Background audio playback via react-native-track-player
• Full-screen player with blurred album art background
• Audio visualizer bars
• Swipe gestures on mini player (swipe left/right for next/prev, swipe up for full screen)
• Queue management screen
• Sleep timer (15/30/45/60/120 min presets)
• Shuffle and repeat modes
• Bass boost toggle
• Seekable progress bar
• Lock screen & notification controls

SEARCH & DISCOVERY:
• SoundCloud API integration
• Debounced auto-search (500ms)
• Infinite scroll pagination (Load More)
• Skeleton shimmer loading animations
• Pull-to-refresh on all screens

USER SYSTEM:
• Sign up / Sign in / Sign out
• Like/unlike tracks with persistent storage
• Create and manage playlists
• Add tracks to playlists from the player
• User settings with persistent preferences

SETTINGS:
• Audio quality (High/Low)
• Autoplay toggle
• Bass Boost toggle
• Notification controls
• Explicit content filter
• Clear cache

DESIGN:
• Premium dark theme (pure black & white)
• Custom NW app icon with neon glow
• Animated splash screen with logo reveal
• Gradient hero sections
• Smooth micro-animations throughout
• Skeleton loading placeholders

TECH STACK:
• React Native 0.83 + Expo SDK 55
• TypeScript
• Zustand state management
• SQLite local database
• expo-router file-based navigation
• react-native-track-player for audio
• expo-linear-gradient
• expo-secure-store

SoundCloud Integration
Background Audio Playback
Full-Screen Player with Blur
Audio Visualizer
Swipe Gestures
Queue Management
Sleep Timer
Shuffle & Repeat
Bass Boost
Skeleton Loading
Debounced Search
Infinite Pagination
Pull-to-Refresh
User Authentication
Playlist Management
Offline Caching
Dark Premium UI
Animated Splash Screen
Lock Screen Controls
Settings with Persistence

• Node.js 18+
• npm or yarn
• Expo CLI (npx expo)
• Android Studio (for Android builds)
• Xcode (for iOS builds, macOS only)
• Python 3 (for auto-patching react-native-track-player)

1. Unzip the project folder
2. Run: npm install
3. Run: npx expo prebuild --platform android
4. Run: npx expo run:android (or npx expo run:ios)
5. The app will launch with the animated splash screen

To customize:
- Branding: Edit src/theme/index.ts for colors, app.json for app name
- Icons: Replace files in assets/ folder
- Audio source: Modify src/lib/soundcloud.ts to use your own API

Documentation is included in the README.md file.