Skip to content

README.md

Latest commit

 

History

History
68 lines (51 loc) · 2.11 KB

README.md

File metadata and controls

68 lines (51 loc) · 2.11 KB

10-Minute Notifier Android App

Android app that sends inspirational quote notifications every 10 minutes at precise intervals (XX:00, XX:10, XX:20, etc.).

🚀 Quick Setup

1. Open in Android Studio

  1. Launch Android Studio
  2. File → Open → Select C:\dev\TenMinuteNotifier
  3. Wait for Gradle sync to complete

2. Update Quote Service URL

CRITICAL: Before building, edit QuoteManager.kt line 27:

private val quotesUrl = "https://[YOUR-USERNAME].github.io/my-quotes-service/quotes.json"

Replace [YOUR-USERNAME] with your actual GitHub username.

3. Build APK

  1. Build → Build Bundle(s) / APK(s) → Build APK(s)
  2. Wait for build completion
  3. APK location: app/build/outputs/apk/debug/app-debug.apk

4. Install on Device

  • Transfer APK to phone and install
  • Grant notification permissions
  • Disable battery optimization for reliable alerts
  • Enable 10-minute notifications in app

📱 Features

  • Precise timing: Notifications at exact 10-minute marks
  • Quote integration: Random inspirational quotes in each notification
  • Battery optimization: Bypasses Doze mode for reliable delivery
  • Offline support: Quotes cached locally, works without internet
  • Auto-restart: Notifications resume after device reboot

🛠️ Development Notes

  • Package: com.tenminutenotifier
  • Min SDK: API 21 (Android 5.0)
  • Target SDK: API 33 (Android 13)
  • Language: Kotlin

📋 Setup Checklist

  • Open project in Android Studio
  • Update GitHub username in QuoteManager.kt
  • Set up GitHub Pages quote service (see quote-service-guide.md)
  • Build and install APK
  • Grant permissions and disable battery optimization
  • Test notifications at 10-minute intervals

🔧 Troubleshooting

Notifications not appearing?

  • Check battery optimization settings
  • Verify notification permissions
  • Ensure exact alarm permission granted

Quotes not loading?

  • Verify GitHub Pages URL is accessible
  • Check internet connection for initial download
  • Test quote refresh button in app

Ready to build! Open in Android Studio and follow the setup steps.