Magic Numbers Magic Numbers is an ad-free, offline, and open-source Android app that generates spiritual numerology messages based on the "rhythm of the moment". It combines clean Material 3 design with mystical insights. You can download the latest release directly from GitHub.

✨ Features

• Rhythm of the Moment Generation: The number is generated on-demand using a random generator seeded with the exact millisecond of your interaction (System.currentTimeMillis()), capturing the unique “energy” of that moment.
• 6-Digit Message Number: Generates a unique 6-digit sequence (000000 - 999999), allowing for significant leading zeros (e.g., 082009).
• Deep Numerology Analysis:
  • Calculates the digit sum (cross sum / Quersumme) as the numerological base.
  • Master & Special Numbers: Detects high-vibration numbers (11, 22, 33, 44, 55, 66, 77, 88, 99) before reduction and assigns deep spiritual meanings instead of standard single-digit interpretations.
  • Karmic Debt Detection: Identifies specific karmic debt numbers (13, 14, 16, 19) and karmic lessons (10) in the cross sum, providing insights into life lessons and independence.
• Intelligent Pattern Recognition:
  • Angel Numbers: Detects classical sequences (e.g., 111, 222, 000) inside the generated number.
  • Smart Overrides: The app recognizes when visual number patterns (e.g., "333" in 101333) are more dominant than the base cross sum, adjusting the message summary and energy flow accordingly to reflect the most relevant spiritual message.
  • Combination Logic: Analyzes powerful pairings, such as Endings & New Beginnings (1 & 9), Structure & Success (4 & 8), or Master Alliances (11 & 22).
• Detailed Interpretations:
  • Component Breakdown: Explains the vibration of every distinct digit (0–9) found in your number.
  • Amplification: Highlights repeated digits (e.g., "0 appears 3 times") and explains their amplifying effect on the total energy.
  • Cross Sum Display: Visualizes the math behind the meaning (e.g., 0 + 8 + 2 + 0 + 0 + 9 = 19).
• Vibration Frequency Meter 🌀: A visual bar indicates the energetic frequency score (percentage) of the generated number, influenced by the presence of master numbers and high-vibration digits.
• Privacy First:
  • 100% Offline.
  • No tracking, no analytics, no ads.
  • No internet permission required (except for opening the optional donate link in a browser).
• User Friendly:
  • Modern Material 3 Design (Dark Mode).
  • Copy functionality for sharing messages (copies the full formatted result to the clipboard).
  • Donate Button 🤝: Support the developer directly via PayPal.

🛠 Technical Details

• Language: Kotlin
• UI Framework: Jetpack Compose (Material 3)
• Architecture: Single Activity, State Management via rememberSaveable (screen rotation support).
• Minimum SDK: 24 (Android 7.0)
• Target SDK: 35+
• License: MIT License

🌍 Localization

The app is fully translated into:

• 🇸🇦 Arabic (العربية)
• 🇧🇬 Bulgarian (Български)
• 🇨🇳 Chinese Simplified (简体中文)
• 🇭🇷 Croatian (Hrvatski)
• 🇨🇿 Czech (Čeština)
• 🇩🇰 Danish (Dansk)
• 🇳🇱 Dutch (Nederlands)
• 🇬🇧 English (UK)
• 🇺🇸 English (US)
• 🇪🇪 Estonian (Eesti)
• 🇫🇮 Finnish (Suomi)
• 🇫🇷 French (Français)
• 🇩🇪 German (Deutsch)
• 🇬🇷 Greek (Ελληνικά)
• 🇮🇱 Hebrew (עברית)
• 🇮🇳 Hindi (हिन्दी)
• 🇭🇺 Hungarian (Magyar)
• 🇮🇩 Indonesian (Bahasa Indonesia)
• 🇮🇹 Italian (Italiano)
• 🇯🇵 Japanese (日本語)
• 🇰🇷 Korean (한국어)
• 🇱🇻 Latvian (Latviešu)
• 🇱🇹 Lithuanian (Lietuvių)
• 🇳🇴 Norwegian (Norsk)
• 🇵🇱 Polish (Polski)
• 🇵🇹 Portuguese (Português)
• 🇷🇴 Romanian (Română)
• 🇷🇺 Russian (Русский)
• 🇷🇸 Serbian (Српски)
• 🇸🇰 Slovak (Slovenčina)
• 🇸🇮 Slovenian (Slovenščina)
• 🇪🇸 Spanish (Español)
• 🇸🇪 Swedish (Svenska)
• 🇹🇭 Thai (ไทย)
• 🇹🇷 Turkish (Türkçe)
• 🇺🇦 Ukrainian (Українська)
• 🇻🇳 Vietnamese (Tiếng Việt)

📱 Screenshots

Welcome Screen	Message View

(To display these images, create an art folder in the project's root directory and place your app's icon and screenshots there.)

🛠️ Built With

• Kotlin: As the primary programming language.
• Jetpack Compose: For the declarative and modern UI toolkit.
• Material Design 3: For design components and theming.
• Android Studio: As the Integrated Development Environment (IDE).

🚀 Getting Started

You can download the app from the Google Play Store (link will be added here once available) or build the project yourself.

Building from Source

1. Clone this repository:
2. Open the project in the latest version of Android Studio.
3. Let Gradle sync the project dependencies.
4. To sign the app for release, you will need to create your own keystore.properties file or modify the signingConfigs block in the app/build.gradle file.
5. Run the app on an emulator or a physical device.

🤝 Contributing

Contributions are welcome!

1. Fork the project.
2. Create your feature branch (git checkout -b feature/AmazingFeature).
3. Commit your changes (git commit -m 'Add some AmazingFeature').
4. Push to the branch (git push origin feature/AmazingFeature).
5. Open a Pull Request.

📜 License

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