Discover the stories behind your music with AI companions

Melodia connects your Spotify listening history with specialized AI agents for immersive conversations about your favorite songs.

Visit the project page: https://www.benatakan.com/projects

• Spotify Integration: Secure authentication and listening history access
• AI Conversations: Chat with specialized music AI agents about your tracks
• Multi-Agent System: Different AI personalities for diverse music insights
• Onboarding Flow: Personalized setup for first-time users
• Clean Interface: Music-focused, intuitive design

• Frontend: React Native with Expo
• State Management: Zustand
• Navigation: Custom Navigation System
• Authentication: Spotify OAuth 2.0
• Storage: Expo SecureStore
• Language: TypeScript

melodia/
├── 📱 src/                   # Source code
│   ├── screens/              # Screen components
│   │   ├── auth/             # Authentication screens
│   │   ├── main/             # Main application screens
│   │   └── onboarding/       # Onboarding flow
│   ├── navigation/           # Custom navigation system
│   ├── hooks/                # Custom React hooks
│   └── types/                # TypeScript definitions
├── 🤖 agents/                # AI agent system
├── 🔧 services/              # External service integrations
├── 🏪 store/                 # State management (Zustand)
├── 🧩 components/            # Reusable UI components
├── 📝 types/                 # Global TypeScript definitions
└── ⚙️ utils/                 # Helper functions

• Node.js 18+
• Expo CLI (npm install -g @expo/cli)
• Spotify Developer Account

1. Clone and install

   git clone https://github.com/yourusername/melodia.git
   cd melodia
   npm install

2. Environment Setup

   cp .env.example .env
   # Add your Spotify Client ID

3. Start development

   npx expo start

1. Create a Spotify app at Spotify Developer Dashboard
2. Add redirect URI: spoti://auth/callback
3. Copy your Client ID to .env

• Expo Documentation
• React Native Docs
• Spotify Web API
• Zustand - State management
• Development Rules - Package and coding guidelines

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run npm run lint
5. Commit and push
6. Open a Pull Request

Atakan Savaş

• Website: benatakan.com
• Project Portfolio: benatakan.com/projects

Visit Project Page

Made with ❤️ for music lovers