README.md

BeatDroid

BeatDroid is a cross-platform mobile app built with Expo and React Native that lets you create stunning, Pinterest-style music posters from your favorite tracks and albums. With seamless Spotify integration, customizable themes, and offline support, BeatDroid makes it easy to design, save, and share unique music art directly from your Android or iOS device.

Key Features

• Connect to Spotify and search for tracks or albums
• Instantly generate and customize music posters
• Choose from multiple layouts and color themes
• Save posters to your device or share them with friends
• Offline mode for creating posters without an internet connection

Getting Started

Prerequisites

• Node.js (LTS recommended)
• npm or yarn
• Expo CLI:

  npm install -g expo-cli

Installation & Running

1. Install dependencies:

   npm install
   # or
   yarn install

2. Start the Expo development server:

   npx expo start
   # or
   expo start

3. Open the app:
   • Launch on an emulator/simulator from the Expo Dev Tools

Project Structure

• /app: Main application screens and navigation
• /components: Reusable UI components
• /lib: Utility functions and hooks
• /assets: Images and static resources

Useful Scripts

• npm run android: Run the app on an Android device/emulator
• npm run ios: Run the app on an iOS simulator

Learn More

• Expo Documentation
• React Native Documentation
• Expo Router
• BeatPrints

---

Start creating and sharing your own music posters with BeatDroid!