PuffLess v1.5 — Premium Smoking Reduction & Quit Support App
Complete Android source code | Kotlin | Jetpack Compose | Material 3 | Offline-first | Optional Firebase | Integrated AdMob
A thoughtfully designed smoking tracker with a refined interface, live home-screen widget, guided craving support, progress insights, and configurable monetization.
Google Play demo link (provided by the seller):
https://play.google.com/store/apps/details?id=com.kalitut.puffless
A Clean, Premium Experience — Built for Everyday Use
PuffLess helps users track cigarettes smoked, record cravings they resisted, set reduction goals, and follow their progress over time. Its modern Android interface combines a compact Home dashboard, a five-minute craving pause, motivational content, detailed activity and progress views, and a responsive home-screen widget.
Version 1.5 introduces a more cohesive visual experience across Home, Craving Support, and Settings, together with integrated, independently configurable AdMob placements. For buyers, the package includes the Android source and a step-by-step setup manual for customization, Firebase, advertising, and release preparation.
At a Glance
- Premium Compose UI: clean surfaces, expressive green accents, refined Home dashboard, and compact minimal-luxury Settings.
- Works offline: core tracking, goals, statistics, reminders, and widget functionality use local Room and DataStore storage.
- Optional cloud features: Firebase sign-in and account-scoped Firestore synchronization when configured.
- AdMob already integrated: banner and app-open ad placements, Firebase Remote Config switches, and Google UMP consent handling.
- Four languages: English, Arabic, French, and Spanish, with RTL-aware Android UI support.
- Flexible appearance: Light, Dark, System, and Material You/dynamic color options using a shared theme system.
Key Features
Smoking & Craving Tracking
- Quickly record a smoked cigarette or a craving passed / cigarette skipped.
- Record context such as drinking, stress, or coffee when logging smoking events.
- Set and adjust daily goals and reduction preferences; view progress against the configured limit.
- Correct supported history entries while keeping the application’s existing tracking logic.
- View smoke-free time, cravings resisted, estimated savings, and related progress indicators.
Guided Craving Support
- Five-minute pause with live countdown and calm, supportive guidance.
- Visual 4–7–8 breathing sequence with phase-responsive animation.
- Record a completed craving as resisted or return to the day without changing the underlying event logic.
- Optional inline banner placed below the supportive content, away from the breathing dial and action buttons.
Progress, Activity & Motivation
- Activity/history, reporting, and day details, including hourly breakdowns.
- Progress charts, daily-limit trends, streaks, achievements, and recovery-related milestones.
- Daily missions, motivational messages, and personalized reasons to keep going.
- Estimated money saved and spending insights based on user-supplied cigarette pricing.
- CSV export functionality for supported activity data.
- Compact Jetpack Glance home-screen widget styled to match the app.
- Today’s smoked/skipped indicators and quick recording actions.
- Reactive updates when tracked data changes, with a tighter layout and less unused space.
Minimal-Luxury Settings
- Streamlined grouped settings with clear labels, values, and subtle separators instead of unnecessary dashboard cards.
- Daily plan, cost/currency, smoking profile, reminders, appearance, account, and privacy settings.
- Consistent Account & Sync, Privacy, About, sign-in/sign-up, and selection screens.
- Single theme source of truth for common visual tokens and Light/Dark/System appearance.
Included App Experiences
- Onboarding: initial preferences and daily reduction goal.
- Home: compact daily progress ring, stats, craving pause entry, missions, Daily Why, and quick actions.
- Craving Support: five-minute pause, animated breathing guidance, motivation, and optional ad placement.
- Activity: tracking history and reports, with individual day details.
- Progress: statistics, milestones, streaks, achievements, and savings.
- Settings: plan, profile, notifications, theme, language, privacy, and optional account features.
- Home-screen widget: live counters and quick actions.
- Optional Firebase screens: sign-in, sign-up, and account/cloud management when enabled.
Integrated AdMob Monetization
AdMob is included in v1.5; no separate ad-integration service is required. Placements use existing app lifecycle safeguards and Google User Messaging Platform (UMP) consent controls. Publishers supply their own AdMob IDs and enable the placements they want through Firebase Remote Config.
- Activity banner: Inline banner in Activity. Remote Config switch: ads_activity_enabled.
- Home banner: Below the five-minute pause card. Remote Config switch: ads_home_enabled.
- Craving Support banner: After breathing guidance and motivation, not over the exercise. Remote Config switch: ads_sos_enabled.
- Progress banner: Inline banner in Progress. Remote Config switch: ads_progress_enabled.
- App-open ad: Controlled by application eligibility and consent rules. Remote Config switch: ads_app_open_enabled.
Global master switch: ads_enabled. A placement also requires the corresponding published switch, a successful/fresh Remote Config fetch, valid ad identifiers, SDK readiness, and permitted consent. The Home and Craving Support switches are independent and default to off in the bundled configuration.
Optional ad unit settings: separate Home and SOS banner IDs are supported; if omitted, these placements reuse the configured Activity banner unit. See Docs/index.html for detailed instructions.
Ad format clarification: the source includes banners and an optional app-open ad; it does not implement an exit interstitial.
Optional Firebase Cloud Features
PuffLess works locally without a Firebase account. Buyers can optionally connect their own Firebase project to add:
- Authentication: email/password and Google Sign-In.
- Cloud sync: account-scoped Firestore storage and WorkManager-backed synchronization.
- Remote Config: managed, independently enabled advertising placements.
- Account deletion: a Firebase Functions callable backend, enabled only after the buyer deploys and tests it.
- Optional diagnostics: Firebase Analytics/Crashlytics integration, subject to the project’s configuration and consent settings.
The app uses manual Firebase initialization for its standard configuration. A google-services.json file is not required for that normal path; an optional Crashlytics mapping-upload setup has its own requirements. The buyer guide explains the difference.
Important: Firebase, Google Sign-In, AdMob, UMP consent messages, Cloud Functions deployment, and Google Play publishing all require customer-owned accounts and configuration. Some cloud services may have provider usage costs. No separate custom VPS is required for the included optional Firebase architecture.
Technical Specifications
- App version: 1.5
- Language: Kotlin
- UI: Jetpack Compose, Material 3
- App structure: ViewModel-based presentation, Hilt dependency injection, Navigation Compose
- Local storage: Room database and DataStore preferences
- Background tasks: WorkManager
- Home-screen widget: Jetpack Glance
- Optional backend: Firebase Authentication, Firestore, Remote Config, Functions, Analytics and Crashlytics
- Advertising: Google Mobile Ads SDK, UMP consent
- Minimum Android SDK: API 26 (Android 8.0)
- Compile / target SDK: API 37 / API 37
- Gradle wrapper: 9.8.2
- Java / Kotlin bytecode target: 17; Gradle daemon JDK requirements are documented in the project
- Localization: English, Arabic, French, Spanish
Use a recent Android Studio release compatible with the bundled Android Gradle Plugin and the project’s declared Gradle daemon JDK. Install the required SDK packages and accept their licenses before building.
What’s Included
- Complete Android Studio source code for PuffLess v1.5.
- Firebase Functions backend source for the optional account-deletion flow.
- Premium layouts for Home, Craving Support, minimal-luxury Settings, and their linked screens.
- Glance widget, local storage, scheduling, statistics, and existing application logic.
- Integrated AdMob and UMP implementation with configurable Remote Config placements.
- Buyer documentation: offline HTML manual (Docs/index.html) and editable Markdown chapters in Docs/DOCUMENTATION/.
- Setup, rebranding, Firebase, AdMob, privacy, troubleshooting, and publishing guides.
Getting Started
- Extract the purchased ZIP and open the Puffless Android project folder in Android Studio.
- Install the required Android SDK components; let the bundled Gradle wrapper synchronize dependencies.
- For a first offline build, leave enableFirebase=false and enableAdMob=false in gradle.properties.
- Run the app and check onboarding, tracking, Home, Craving Support, Activity, Progress, Settings, and the widget.
- Open Docs/index.html for the guided rebrand, Firebase setup, AdMob/UMP configuration, and release checklist.
- Before publishing, use your own package name, app branding, Firebase/AdMob credentials, privacy policy, signing key, and Play Console configuration.
Release safety: test-only Android App Bundles are intentionally distinguished from publisher builds. Production publishing requires genuine configuration and signing validation; a successful Debug build alone is not Play Store certification.
Frequently Asked Questions
Q: Does PuffLess work without Firebase?
Yes. The core tracking experience is offline-first. Firebase-backed account and sync features require a configured Firebase project.
Q: Is AdMob already implemented?
Yes. PuffLess v1.5 includes Home, Craving Support, Activity, and Progress banners and an optional app-open ad. Each is independently controlled through Remote Config, alongside the global switch and UMP consent rules.
Q: Why is my Home or Craving Support banner not visible?
Set and publish ads_enabled=true plus ads_home_enabled=true or ads_sos_enabled=true, respectively, in your own Firebase Remote Config project. Valid IDs, successful configuration fetch, SDK readiness, consent, and ad availability are also required.
Q: Can I change the branding and theme?
Yes. The included guides cover the app name, icons, package ID, shared theme, localized strings, and the necessary external-service reconfiguration.
Q: Are the screens and widget customizable?
Yes. They are implemented in Kotlin with Jetpack Compose and Jetpack Glance, respectively. The current theme uses shared design tokens rather than separate, conflicting Settings palettes.
Q: Does it include a subscription or payment system?
No. The included monetization implementation is AdMob. Billing or subscription features would require separate development.
Q: Do I need a separate server?
No custom VPS is needed for the offline app or the included optional Firebase approach. Enabling cloud functions and synchronization requires setting up the relevant Firebase services in your own project.
Q: Is it ready for immediate Google Play upload?
It is a source-code product. You must rebrand it, configure external services, provide your own release signing and legal disclosures, test your build, and satisfy Google Play’s current publishing requirements.
Version 1.5 — Update Highlights
- Refined Home: more premium visual treatment, tighter daily-progress hero, smaller five-minute pause card, and inline Home ad placement.
- Craving Support refresh: richer breathing visualization, phase-responsive animation, clear countdown, motivational surface, and independent SOS banner placement.
- Minimal-luxury Settings: simplified grouping, clearer label/value rows, reduced clutter, and consistent linked screens and selection controls.
- Improved widget: compact Glance layout, reduced unused vertical space, reactive counters, and quick actions.
- Expanded ad controls: Home and SOS Remote Config flags in addition to existing Activity, Progress, and app-open controls, with consent gating.
- Firebase and account features: account-scoped sync and documented managed account-deletion backend configuration.
- Localization and design: English, Arabic, French and Spanish resources; coherent Light/Dark/System/Material You styling.
- Code quality and documentation: improved internal naming, focused cleanup, bug fixes, and updated buyer setup, release and customization guides.
Version: 1.5 | Release type: Android source code
Documentation & Support
Start with the included Docs/index.html guide. It walks through initial setup, customization, Firebase, AdMob, account deletion, testing, and publishing. For purchase-related questions and support, use the seller’s CodeCanyon profile/contact options.
Note: PuffLess is a smoking-tracking and self-support application, not a medical device or a guarantee of smoking cessation or health outcomes. End users’ local data is not represented as encrypted by default. Buyers are responsible for their own privacy disclosures, AdMob/Firebase account configuration, platform compliance, and applicable licenses.
PuffLess v1.5 — A refined Android foundation for smoking reduction and quit-support experiences.