Skip to content

Repository files navigation

AstroYorum 🌟

Android Kotlin Supabase GPT OSS 120B Groq License Version

AstroYorum is an interactive astrology, tarot, and moon phase tracking application built for Android. Designed with a seamless and modern UI using Jetpack Compose, this app brings the mysteries of the universe straight to your pocket with personalized daily horoscopes generated by GPT OSS 120B AI (via Groq).

🚀 Release Notes

For a detailed list of all new features, improvements, and bug fixes, please see the CHANGELOG. (Tüm yenilikler, iyileştirmeler ve hata düzeltmelerinin detaylı listesi için lütfen SÜRÜM NOTLARI dosyasına göz atın.)

🔮 Features

  • Daily Horoscopes: Get personalized daily horoscopes for all 12 zodiac signs, dynamically generated every midnight by GPT OSS 120B AI.
  • Tarot Readings: A beautifully animated 3-card spread (Past, Present, Future) to help you find answers and balance in your life.
  • Moon Phases: Real-time tracking of the current moon phase, illumination percentage, and related astrological energies.
  • AdMob Integration: Fully integrated with Google AdMob for Banner, Interstitial, and Rewarded ads.

🛠️ Technology Stack

  • UI & Layout: Kotlin & Jetpack Compose (Material 3)
  • Architecture: MVVM (Model-View-ViewModel)
  • Backend & AI: Supabase (PostgreSQL Database, Edge Functions), Groq API (GPT OSS 120B)
  • Monetization: Google Mobile Ads SDK (AdMob)
  • Image Loading: Coil
  • Local Storage: DataStore (Preferences)
  • Navigation: Jetpack Navigation Compose

🔐 Security

All sensitive credentials such as Keystore Passwords, Supabase Keys and AdMob API Keys are completely isolated from the repository using local.properties and injected dynamically into BuildConfig during the build process, ensuring maximum repository security. Groq API keys are also secured via Supabase environment configurations.

💡 Open Source Template & Setup

This repository serves as a ready-to-use template for an AI-powered Android application. Because all sensitive credentials (like Supabase API keys and AdMob keys in local.properties) are excluded from this repository for security reasons, the app will not compile or run out-of-the-box.

If you want to use this boilerplate to build your own app, you must:

  1. Connect the app to your own Supabase project and add SUPABASE_URL and SUPABASE_ANON_KEY to your local.properties file.
  2. Set up Supabase Edge Functions with your own Groq API key.
  3. Add your own AdMob App ID and Unit IDs to your local.properties file.

(Bu repo, şifreler ve API anahtarları gizlendiği için doğrudan çalıştırılamaz. Kendi projenizde kullanmak isterseniz kendi Supabase, Groq ve AdMob hesaplarınızı bağlamanız gerekmektedir.)

📄 License

This project is licensed under the MIT License - see the LICENSE file for details. Copyright (c) 2026 gokcank

About

AI-powered Astrology and Tarot App for Android built with Kotlin and Jetpack Compose.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages