🌅 Aurora

AI DJ for Your Mind & Music

A minimalist, offline-first music player with AI-powered personalization. Experience your music like never before with an intelligent DJ that understands your vibe.

📚 Documentation

Guide	Description
🏗️ Architecture	High-level overview, state management, navigation
🧩 Components	Component types, patterns, best practices
🛡️ Error Handling	Result type pattern, user-facing errors
📝 Logger	Logging setup, usage, production logging
🧪 Testing	Unit tests, integration tests, CI/CD
🤝 Contributing	How to contribute, coding standards

New to Aurora? Start with Architecture → Components → Testing

✨ Features

🎵 Music Playback

Play local music files from your device
Create and manage custom playlists
Shuffle and repeat modes
Beautiful full-screen player with lyrics support
Mini player for seamless multitasking

🤖 AI DJ

Multi-Provider Support: Google Gemini, Groq, and local Ollama models
Natural Control: Chat with your AI to change themes, add music, adjust settings
Custom Personas: Define your AI's personality
Smart Actions: AI can execute app commands through conversation
Chat History: Last 50 messages saved locally

🎨 Theme System

35+ Premium Themes: Cyberpunk, Matrix, Cosmos, Nebula, and more
Dynamic Themes: Music rhythm-based theme transitions
Custom Themes: Create themes with AI or manually
Light/Dark/System mode support

🌊 Background Effects

18+ Animated Effects: Bokeh, Quantum, Waves, DNA, Matrix, and more
Dynamic Switching: Effects respond to your music
Custom Effects: AI-generated background configurations

🔒 Privacy First

100% Offline: No internet required (except AI features)
Zero Data Collection: Your data stays on your device
Local Storage: SQLite + MMKV for fast, secure storage
No Ads: Clean, uninterrupted experience

🌍 Internationalization

English and Turkish support
Auto-detect device language
Easy to extend with more languages

🔒 Security Note

Local Network Connections (HTTP)

For local AI integration (Ollama and Stable Diffusion), Aurora uses standard HTTP connections to communicate with services running on your local machine or LAN.

Ollama: Connects via http://[IP]:[PORT]/api/chat
Stable Diffusion: Connects via http://[IP]:[PORT]/sdapi/v1/txt2img

Important

Since these connections are unencrypted (HTTP), they are intended for use within trusted local networks only. If exposing these services over a public network, it is highly recommended to use a reverse proxy with HTTPS (like Nginx or Caddy).

🚀 Quick Start

Prerequisites

Node.js 18+
npm or yarn
Expo CLI
iOS Simulator (Mac) or Android Emulator

Installation

# Clone the repository
git clone https://github.com/neurodivergent-dev/aurora.git
cd aurora

# Install dependencies
npm install

# Start the development server
npm start

# Run on iOS
npm run ios

# Run on Android
npm run android

# Run on Web
npm run web

Clean Install (if needed)

# Windows PowerShell
.\clean-reinstall.ps1

# Reset Metro cache
.\reset-metro.ps1

📱 Screenshots

Add your screenshots here:

assets/screenshots/home.png

assets/screenshots/player.png

assets/screenshots/ai-chat.png

assets/screenshots/themes.png

🏗️ Tech Stack

Category	Technology
Framework	React Native + Expo SDK 55
Language	TypeScript
Navigation	expo-router (file-based)
State	Zustand + persist middleware
Storage	MMKV, AsyncStorage, SecureStore
Database	expo-sqlite
AI	Google Gemini, Groq, Ollama
Media	expo-av
Animations	react-native-reanimated
Icons	lucide-react-native
i18n	i18next + react-i18next
Testing	Jest + Testing Library

📂 Project Structure

aurora/
├── app/                    # Expo Router screens
│   ├── (tabs)/            # Tab navigation
│   │   ├── index.tsx      # Library
│   │   ├── playlists.tsx
│   │   ├── ai-chat.tsx
│   │   └── settings.tsx
│   ├── music-player.tsx
│   └── _layout.tsx
│
├── src/
│   ├── components/        # Reusable UI components
│   ├── screens/           # Screen components
│   ├── store/             # Zustand stores
│   ├── services/          # Business logic
│   ├── lib/               # Core utilities (database)
│   ├── hooks/             # Custom hooks
│   ├── utils/             # Helper functions
│   ├── constants/         # Themes, categories, prompts
│   └── i18n/              # Translations
│
├── assets/
│   ├── images/            # Icons, splash screens
│   ├── fonts/             # Custom fonts
│   └── sounds/            # Default music tracks
│
├── scripts/               # Build scripts
├── scripts/               # Build scripts
└── package.json

🎯 Configuration

AI Setup

To use AI features, configure your API keys in the app settings:

Open Settings → AI Settings
Choose your provider (Gemini, Groq, or Ollama)
Enter your API key
Start chatting with your AI DJ

Package ID

iOS Bundle ID: com.metaframe.aurora
Android Package: com.metaframe.aurora

To change, update app.json and rebuild.

🧪 Testing

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Run in CI mode
npm run test:ci

# Type check
npm run typecheck

# Lint
npm run lint

Coverage Targets

Directory	Target	Status
`src/utils`	80%	✅ 70%
`src/store`	80%	🟡 40%
`src/hooks`	70%	🟡 30%
`src/services`	70%	🟡 25%
Overall	30%	🟡 ~10%

📖 Learn More: Testing Best Practices

🚀 Building for Production

Android

# Build APK
eas build --platform android --profile preview

# Build for Play Store
eas build --platform android --profile production

iOS

# Build for TestFlight
eas build --platform ios --profile production

EAS Configuration

See eas.json for build profiles.

📄 Features Roadmap

🤝 Contributing

Contributions are welcome! We appreciate all types of contributions:

🐛 Bug reports
💡 Feature suggestions
📝 Documentation improvements
🧪 Test additions
🎨 Design enhancements
🌍 Translations

Getting Started

Read Contributing Guide
Read Architecture Overview
Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Make your changes (follow coding standards)
Write tests (see Testing Guide)
Commit your changes (git commit -m 'feat: add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

Code Style

✅ TypeScript for all code
✅ ESLint + Prettier configured
✅ Logger instead of console.log
✅ Error handling with Result type
✅ Accessibility labels on touchables
✅ Tests for new features

📖 Full Guide: CONTRIBUTING.md

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 About MetaFrame

Aurora is developed by MetaFrame, a studio focused on creating smart tools for modern life.

Other Apps by MetaFrame

FocusTabs - Productivity & Focus
Mindbook Pro - Mental Health & Journaling
Mindbook Trial - Free version
Aurora - AI Music Player (this app)

🌐 Publisher Page: APPLION - MetaFrame

📚 Additional Resources

Documentation

Project Status

Learn More

📬 Contact

GitHub: @neurodivergent-dev
Project Link: github.com/neurodivergent-dev/aurora

Made with ❤️ and AI

"Your music, amplified by intelligence."

Name		Name	Last commit message	Last commit date
Latest commit History 32 Commits
.circleci		.circleci
.vscode		.vscode
app		app
assets		assets
components		components
constants		constants
docs		docs
fixes		fixes
qwen_architecture_docs		qwen_architecture_docs
scripts		scripts
src		src
.easignore		.easignore
.env.example		.env.example
.eslintrc.js		.eslintrc.js
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
TESTING.md		TESTING.md
app.config.ts		app.config.ts
app.json.bak		app.json.bak
babel.config.js		babel.config.js
clean-reinstall.ps1		clean-reinstall.ps1
code_review.md		code_review.md
eas.json		eas.json
features		features
fix-adb.ps1		fix-adb.ps1
implementation_plan.md		implementation_plan.md
jest.config.js		jest.config.js
jest.setup.js		jest.setup.js
manual_tests.md		manual_tests.md
metro.config.js		metro.config.js
package-lock.json		package-lock.json
package.json		package.json
reset-metro.ps1		reset-metro.ps1
roadmap.md		roadmap.md
task.md		task.md
themeHandler_refactoring_plan.md		themeHandler_refactoring_plan.md
tsc_errors.log		tsc_errors.log
tsc_final_log.txt		tsc_final_log.txt
tsc_output.txt		tsc_output.txt
tsc_output_utf8.txt		tsc_output_utf8.txt
tsc_refactor_errors.txt		tsc_refactor_errors.txt
tsconfig.json		tsconfig.json
type_safety_execution_summary.md		type_safety_execution_summary.md
type_safety_fix_prompt.md		type_safety_fix_prompt.md

Folders and files

Latest commit

History

Repository files navigation

🌅 Aurora

📚 Documentation

✨ Features

🎵 Music Playback

🤖 AI DJ

🎨 Theme System

🌊 Background Effects

🔒 Privacy First

🌍 Internationalization

🔒 Security Note

Local Network Connections (HTTP)

🚀 Quick Start

Prerequisites

Installation

Clean Install (if needed)

📱 Screenshots

🏗️ Tech Stack

📂 Project Structure

🎯 Configuration

AI Setup

Package ID

🧪 Testing

Coverage Targets

🚀 Building for Production

Android

iOS

EAS Configuration

📄 Features Roadmap

🤝 Contributing

Getting Started

Code Style

📝 License

👨‍💻 About MetaFrame

Other Apps by MetaFrame

📚 Additional Resources

Documentation

Project Status

Learn More

📬 Contact

About

Topics

Resources

License

Contributing

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages