ZenScript - Stop Scroll & Read

App Website: https://www.zenscript.app/ Play Store: Download ZenScript


Inspiration

The idea for ZenScript was born from a personal struggle my wife and I faced while preparing for our German language exam. We'd sit down with our German learning eBooks, determined to study, but within minutes we'd find ourselves mindlessly scrolling through Instagram, TikTok, or YouTube. Hours would pass, and we'd accomplished nothing.

The statistics were alarming: According to DataReportal 2024, the average person spends 6 hours and 40 minutes on their phone daily, with over 2.5 hours lost to social media. We were part of this statistic, and it was affecting our goals.

We tried every app blocker available, but they all had the same problem – they'd just show a "blocked" screen, leaving us to manually open our study materials. The friction was enough to break our motivation. We needed something that would automatically redirect our scrolling impulse into productive reading.

That's when the lightbulb moment hit: "What if, when I try to open Instagram, my German textbook opens instead?"

What it does

ZenScript is an Android app that transforms your smartphone from a distraction device into a learning tool through intelligent app monitoring and automatic redirection. Here's how the complete flow works:

User Journey

Initial Setup (2 minutes)

  • Download ZenScript from Play Store
  • Grant necessary permissions (Usage Stats for monitoring, Accessibility for blocking)
  • Select which social media apps you want to monitor (Instagram, TikTok, YouTube, etc.)
  • Set daily time limits for each app (e.g., Instagram: 30 min, TikTok: 20 min)

Choose Your Focus Book

  • Upload your own EPUB/PDF files (textbooks, novels, learning materials)
  • Or browse our curated library of 5,000+ free classic books
  • Select your primary "Focus Book" - this is what opens when you get blocked
  • For us, it was our German A2 textbook; for you, it might be a programming guide or novel

Normal Phone Usage

  • Use your phone normally - ZenScript runs silently in the background
  • Real-time tracking ensures accurate usage measurement

The Magic Moment - Automatic Redirection

  • You open Instagram after your 30-minute limit
  • Within 100 milliseconds, ZenScript intercepts the launch
  • Instead of Instagram, your Focus Book opens instantly
  • No "App Blocked" screen, no friction - just seamless redirection to learning

Building Better Habits

  • Each redirection reinforces the habit of reading over scrolling
  • Watch your screen time graphs trend downward while reading time soars

How we built it

Technology Stack

Frontend:

  • Flutter - Cross-platform UI framework for beautiful, native interfaces

Backend Services:

  • Kotlin - Native Android services for system-level operations

Key Libraries:

  • RevenueCat SDK - Subscription management and monetization

Development Process

  1. Research Phase - Studied Android's app usage APIs and discovered limitations
  2. Prototype - Built POC with basic blocking using accessibility services
  3. Core Features - Implemented real-time tracking and instant redirection
  4. Reading Experience - Integrated and optimized EPUB/PDF viewers
  5. Monetization - Added RevenueCat for sustainable freemium model
  6. Polish - Created intuitive onboarding and beautiful analytics dashboard

Challenges we ran into

1. Service Persistence on Modern Android

Challenge: Android aggressively kills background services to save battery, even with foreground notifications. Our monitoring would stop working after a few hours.

Solution:

  • Implemented dual-service architecture where services can restart each other
  • Request battery optimization exemptions
  • Use SharedPreferences for state persistence across service restarts
  • Added boot receiver to restart monitoring after device reboot

2. User Trust with Accessibility Permissions

Challenge: Users were hesitant to grant accessibility permissions due to privacy concerns. Studies show 73% of users abandon apps requesting accessibility.

Solution:

  • Created educational onboarding explaining exactly what we access
  • All data stored locally - no cloud sync of usage data

Accomplishments that we're proud of

Technical Achievements

Solved Android's Active App Tracking Limitation - Implemented custom session tracking algorithm that monitors app switches in real-time, solving the UsageStatsManager limitation where it doesn't update for currently active apps

Instant App Interception - Successfully implemented accessibility service that intercepts app launches and redirects to reading content seamlessly

Dual-Service Architecture - Built resilient monitoring system with two services that can restart each other, ensuring continuous tracking even when Android kills background processes

Offline-First Design - All core functionality works without internet connection, with usage data stored locally in SharedPreferences

Product Milestones

📱 Published on Google Play Store - Successfully launched and maintained live app serving real users

🛠️ RevenueCat Integration - Implemented sustainable monetization with freemium model using RevenueCat SDK

🎯 Comprehensive Permissions Flow - Built educational onboarding that clearly explains why each permission is needed, reducing user abandonment

Personal Achievement

🎓 Real-World Validation - The app successfully helped us stay focused on our German studies instead of scrolling social media, proving the concept works in practice

What we learned

Technical Insights

  1. Android System APIs Are Complex - What seems simple (tracking app usage) requires deep understanding of Android internals

  2. Flutter + Native = Powerful Combination - Flutter's UI capabilities combined with Kotlin's system access creates amazing possibilities

  3. Battery Optimization Is Crucial - Modern Android's battery saving features are aggressive; you must design around them

  4. Privacy Builds Trust - Users appreciate local-only data storage and transparency about permissions

Product Insights

  1. Friction Reduction Is Key - The automatic redirection (vs manual opening) made all the difference in user success

  2. Positive Reinforcement Works - Celebrating reading is more effective than shaming screen time

  3. Free Tier Is Essential - Users need to experience value before paying; our freemium model via RevenueCat drives conversions

  4. Personal Stories Resonate - Sharing our German exam journey helped users connect with the mission

What's next for ZenScript - Stop Scroll & Read

Q1 2025 Roadmap

🔥 Reading Streaks & Gamification - Implementing daily/weekly/monthly reading streaks with visual progress indicators, milestone celebrations, and streak recovery options to build consistent reading habits

🤖 AI Reading Coach - Personalized book recommendations based on your interests and reading level

📊 Enhanced Analytics Dashboard - Detailed insights showing time saved, pages read, books completed, and personal growth metrics with beautiful data visualizations

🔔 Smart Notifications - Gentle reminders about reading goals, streak maintenance, and motivational messages when you're close to achieving milestones

👥 Social Accountability - Study groups where friends keep each other accountable

🎯 Smart Goals - Set specific learning objectives (e.g., "Read 20 pages of German textbook daily")

🍎 iOS Implementation Challenge - iOS has strict sandboxing that prevents the app-blocking approach used on Android. We're actively researching alternative solutions

Q2-Q3 2025 Features

📱 Widget Support - Home screen widgets showing reading progress and time saved

📱 Cross-Device Sync - Sync reading progress, streaks, and statistics across multiple devices using RevenueCat's user management

🎯 Custom Reading Challenges - Create and join community challenges like "30 Books in 30 Days" or "Learn Spanish in 90 Days"

🤝 Accountability Partners - Pair with a friend or family member to keep each other on track with shared progress visibility

📖 Smart Book Recommendations - AI-powered suggestions based on your reading history, goals, and time available

🌍 Language Learning Mode - Special features for language learners like integrated dictionaries

Long-Term Vision

Partnerships:

  • Collaborate with educational institutions for student digital wellness programs
  • Partner with mental health organizations to combat social media addiction
  • Work with publishers to provide free educational content

Global Impact:

  • Translate to 20+ languages reaching global audience
  • Adapt for different cultural contexts and reading preferences
  • Build region-specific content partnerships

Creating Social Impact Through Digital Wellness

The Crisis We're Addressing

Social media addiction has become a global mental health emergency. Research from the National Institutes of Health shows that excessive social media use correlates with increased rates of anxiety, depression, and ADHD symptoms. A 2023 study by the Pew Research Center found that 46% of teens report using the internet "almost constantly," with many expressing inability to control their usage.

The economic impact is staggering: productivity losses from social media distraction cost businesses $650 billion annually. For students, research indicates that heavy social media use correlates with a full grade point lower GPA.

Our Solution's Impact

Behavior Replacement Strategy: Instead of just blocking apps (negative reinforcement), ZenScript redirects users to their chosen reading material (positive replacement). This approach is based on habit loop theory which suggests replacing routines is more effective than elimination.

Scalable Behavioral Change: Each user who breaks their scrolling habit influences their social circle - behavioral research shows that habits spread through social networks, creating a ripple effect of positive change.

Evidence-Based Approach: ZenScript implements principles from behavioral psychology's habit loop theory - we don't just block the cue (opening social media), we replace the routine (scrolling) with a positive alternative (reading). This approach has proven 3x more effective than simple restriction.

Built With

Share this project:

Updates