Focus guard

• 

  interface for focus study

• 

  settings

• 

  adhd test

Inspiration

For the past 4 years, I’ve been teaching students from all walks of life through my small tuition center, Sai Vaishnavi Tutorials. I’ve worked day and night to help them focus, learn, and grow — not just as students, but as individuals.

But one student changed everything.

No matter what I tried — extra hours, personal care, new methods — he wasn’t improving. After taking him to the hospital, we discovered something heartbreaking: he was suffering from ADHD. The culprit? Excessive screen time and social media addiction.

Today’s children are fighting an invisible battle — their attention spans are shrinking, their prefrontal cortex is being affected, and their thinking capabilities are weakening — all due to unregulated screen exposure. Social media is designed to trap minds — especially the young and curious ones.

I’ve lived through this pain. In 2014, my father suffered a blood clot in his head. In 2015, he was struck with fits. I was preparing for UPSC during those tough years. But I had to stop — not because I gave up — but because I saw a bigger mission: to protect this generation from going through what we did.

That’s why I created FocusGuard — not just an app, but a lifesaver.

🌱 It monitors screen time. 🧠 Uses AI to detect ADHD behavior. 🧑‍🏫 Translates tough messages into your favorite celebrity’s voice using 3D avatars. 📱 Sends reminders. Locks phones. Blocks distractions. 👪 Sends daily reports to parents/family — because awareness begins at home.

Every child learns differently — some in English, some in Telugu, Hindi, or Tamil. FocusGuard adapts to them, speaks their language, and builds healthy habits. It's not just an app. It’s my fight — for them, for us.

If I win the Bolt Hackathon, I’ll invest the prize in building an Intermediate College in our area — a place where education is real, not just about marks — and where focus and mental well-being come first.

We don’t need another app to scroll. We need one that saves minds.

This is not a tech product. This is my promise to my students, to my father, to the youth who still have a chance to think free.

– Maale Sai Akhil Creator of FocusGuard | Teacher | Dreamer | Doer

What it does

FocusGuard is an AI-powered mobile app built to protect students and adults from the harmful effects of excessive screen time, especially those prone to ADHD and focus-related disorders.

💡 Core Features: 🧠 ADHD Monitoring & Alerts

Uses AI to track behavioral patterns and alert users or guardians if signs of ADHD are detected early.

Helps with early intervention and awareness.

📱 Screen Time Control & App Blocking

Automatically blocks distracting apps (like Instagram, YouTube, Snapchat) once the user crosses their daily usage limit.

Sends strong reminders and warnings when screen time is too high.

🚨 Emergency Focus Mode (Phone Lockdown)

If screen addiction becomes severe, the app forces a temporary phone shutdown or lockdown to reset focus.

Can be triggered by AI or parents.

📊 Daily Focus Reports to Parents/Guardians

Sends a daily report of usage and focus performance to family members.

Helps build accountability and understanding within the home.

🌍 Multilingual 3D Avatar Assistant

Uses 3D avatars of favorite celebrities or relatable characters to guide, warn, or educate the user — in their preferred language (English, Telugu, Hindi, Tamil, etc.).

Makes learning and recovery interactive and emotionally engaging.

🚫 Pornography and Incognito Mode Blocking

Automatically blocks explicit content, including during incognito browsing, to protect young minds.

🎯 Focus Modes for UPSC, NEET, Coding, etc.

Offers custom focus plans tailored to exam goals or learning habits.

Keeps students on track through personalized nudges and breaks.

💖 Why It Matters: Because this is more than just screen time. It’s about saving attention, purpose, and potential.

How we built it

Frontend React 18 with TypeScript for the user interface Wouter for lightweight client-side routing Tailwind CSS for styling with custom iOS-style design Radix UI components with shadcn/ui design system TanStack Query for server state management Framer Motion for animations Vite as the build tool and development server Backend Node.js with Express.js server TypeScript for type safety tsx for running TypeScript directly Database & Storage PostgreSQL as the main database Neon Database for serverless PostgreSQL hosting Drizzle ORM for type-safe database operations Drizzle Kit for database migrations Key Libraries React Hook Form with Zod validation for forms Lucide React for icons Date-fns for date handling Recharts for analytics charts Development Tools ESBuild for fast JavaScript bundling PostCSS with Autoprefixer Replit-specific tools for deployment Deployment Replit Autoscale for serverless hosting Environment variables for database connection The app combines modern web technologies with a focus on mobile-optimized design, real-time features, and database-driven functionality for focus management and AI learning assistance.

Challenges we ran into

Database Schema Issues Missing Fields: Several database tables were missing required createdAt fields that were referenced in queries SQL Syntax Errors: The initial deployment failed due to PostgreSQL syntax issues with the desc ordering function Type Mismatches: Drizzle ORM type definitions didn't match the actual database schema Complex Data Relationships Multi-table Dependencies: Managing relationships between users, focus sessions, blocked apps, AI chats, and assessments JSONB Data Handling: Storing complex nested data like app schedules, assessment responses, and AI chat history Real-time State Management: Keeping focus sessions and app blocking status synchronized Mobile-First Design Constraints Touch-Friendly Interface: Designing for mobile interactions while maintaining desktop usability iOS-Style Components: Creating custom components that feel native on mobile devices Responsive Layouts: Ensuring consistent experience across different screen sizes AI Integration Complexity Multi-modal Content: Supporting photo uploads, PDF processing, and text input for AI tutors Avatar Personalities: Implementing distinct AI personalities (Einstein, Curie, Tesla) with unique response styles Voice Synthesis: Managing audio generation and playback for AI responses System-Level Features App Blocking Logic: Implementing different blocking levels (soft, hard, system-level) Permission Management: Handling device admin permissions and accessibility services Emergency Overrides: Balancing strict enforcement with necessary escape mechanisms Performance & Scalability Database Queries: Optimizing queries for real-time focus session monitoring File Processing: Handling image and PDF uploads efficiently State Synchronization: Managing complex client-server state with TanStack Query Development Environment TypeScript Configuration: Ensuring type safety across frontend, backend, and shared schemas Hot Reload Issues: Managing development server restarts during rapid prototyping Database Migrations: Using Drizzle Kit for schema changes without data loss The biggest challenge was coordinating the database schema with the application logic while maintaining type safety throughout the entire stack.

Accomplishments that we're proud of

Based on what we've built with the FocusGuard app, here are the key accomplishments:

Technical Achievements Full-Stack TypeScript Integration

Built a complete end-to-end type-safe application using shared schemas between frontend and backend Implemented Drizzle ORM with PostgreSQL for robust data management Created a seamless development experience with hot reload and automatic type checking Advanced AI Learning Platform

Integrated multiple celebrity AI personalities (Einstein, Marie Curie, Tesla) with distinct communication styles Built multi-modal content processing supporting photos, PDFs, and text input Implemented voice synthesis and audio generation for immersive learning experiences Mobile-First Focus Management

Created system-level app blocking with multiple enforcement levels Built real-time focus session monitoring with emergency override capabilities Designed intuitive mobile interface with iOS-style components and touch interactions User Experience Innovation Comprehensive ADHD Support

Developed standardized 18-question ADHD assessment with detailed scoring Created personalized study recommendations based on user behavior patterns Built progress tracking with visual analytics and streak monitoring Flexible Study Systems

Implemented exam-specific modes for UPSC, TSPSC, and general preparation Created customizable study schedules with strict enforcement options Built parental controls and age-appropriate configurations Smart Permission Management

Designed granular permission system for device admin and accessibility services Created clear user-friendly explanations for required permissions Implemented progressive permission requests based on feature usage Engineering Excellence Scalable Architecture

Built modular component system with reusable UI elements Implemented efficient state management with TanStack Query Created maintainable database schema with proper relationships Performance Optimization

Used Vite for fast development builds and hot module replacement Implemented efficient image processing and file upload handling Built responsive design that works across all device sizes Production-Ready Deployment

Configured serverless PostgreSQL with Neon Database Set up automated deployment pipeline with Replit Autoscale Implemented proper error handling and logging throughout the application The most significant accomplishment is creating a comprehensive platform that genuinely helps students and professionals with ADHD manage their focus while providing engaging AI-powered learning experiences.

What we learned

Technical Learnings Database Schema Design

Learned the importance of defining complete schemas upfront - missing createdAt fields caused deployment failures Discovered that PostgreSQL with Drizzle ORM requires careful type alignment between schema definitions and queries Understood how JSONB columns can store complex data while maintaining query performance Full-Stack TypeScript Integration

Mastered sharing types between frontend and backend using a unified schema approach Learned how to leverage Drizzle's createInsertSchema for automatic form validation Discovered the power of end-to-end type safety for catching errors early Mobile-First Development

Learned that designing for mobile constraints actually improves desktop experiences Discovered the importance of touch-friendly interfaces and gesture-based navigation Understood how to create responsive layouts that feel native on mobile devices Product Development Insights User-Centered Design for ADHD

Learned that ADHD users need immediate feedback and clear visual progress indicators Discovered the importance of emergency override features for maintaining user trust Understood how gamification elements like streaks motivate sustained engagement AI Integration Challenges

Learned that personality-driven AI requires careful prompt engineering and consistent character traits Discovered the complexity of handling multi-modal content (photos, PDFs, text) in a unified interface Understood the importance of voice synthesis for accessibility and engagement Permission Management

Learned that users need clear explanations for why invasive permissions are necessary Discovered the balance between strict enforcement and user autonomy Understood how progressive permission requests reduce user friction Development Process Learnings Error-Driven Development

Learned that database deployment errors often reveal schema inconsistencies early Discovered the value of comprehensive logging for debugging complex state interactions Understood how TypeScript errors can guide proper architecture decisions Modern Web Stack Benefits

Learned how Vite's hot reload accelerates development cycles significantly Discovered that TanStack Query simplifies complex client-server state management Understood how Tailwind CSS enables rapid UI iteration without CSS conflicts Deployment and Scaling

Learned the benefits of serverless PostgreSQL for rapid prototyping Discovered how proper environment variable management enables smooth deployments Understood the importance of database migration strategies for production systems The biggest learning was that building accessibility-focused applications requires deep empathy for user challenges, not just technical implementation skills.

What's next for Focus guard

Based on the current state of FocusGuard, here's the roadmap for future development:

Immediate Enhancements (Next 3 months) Enhanced AI Tutoring

Add more celebrity personalities like Stephen Hawking, Maya Angelou, and Leonardo da Vinci Implement subject-specific AI tutors for math, science, history, and languages Build adaptive learning that adjusts difficulty based on user performance Add collaborative study sessions where multiple users can learn together with AI guidance Advanced Analytics Dashboard

Create detailed productivity insights with weekly/monthly reports Build habit tracking with personalized recommendations Add focus score calculations based on session completion rates Implement peer comparison features for competitive motivation Smart Notification System

Develop predictive notifications based on user behavior patterns Add location-based study reminders (when near library, study space) Build integration with calendar apps for automatic study scheduling Create gentle interruption warnings before focus sessions end Medium-term Goals (6-12 months) Cross-Platform Expansion

Develop native iOS and Android apps with system-level blocking Build desktop applications for Windows, Mac, and Linux Create browser extensions for web-based focus management Add smartwatch integration for quick focus controls Advanced ADHD Support

Partner with healthcare providers for clinical assessment integration Build medication reminder systems with progress tracking Add sensory-friendly interface options (reduced motion, high contrast) Implement breathing exercises and mindfulness features Social Learning Features

Create study groups with shared goals and accountability Build mentorship matching between experienced and new users Add family dashboard for parents to monitor without intrusion Implement achievement sharing and celebration systems Long-term Vision (1-2 years) AI-Powered Personalization

Develop machine learning models that predict optimal study times Build personalized curriculum generation based on learning patterns Create adaptive difficulty that responds to emotional state and energy levels Implement natural language processing for conversational study planning Integration Ecosystem

Connect with educational platforms like Khan Academy, Coursera, Udemy Build API for third-party developers to create focus-aware applications Integrate with productivity tools like Notion, Todoist, and Google Workspace Add support for virtual reality study environments Global Accessibility

Expand language support to 20+ languages with native AI tutors Build region-specific exam preparation (SAT, GMAT, GRE, etc.) Create accessibility features for users with various disabilities Develop offline-first capabilities for areas with limited internet The core vision is transforming FocusGuard from a simple app blocker into a comprehensive learning companion that adapts to each user's unique needs and learning style.

Built With

• datefns
• drizzlekit
• drizzleorm
• esbuild
• framermotion
• lucidereact
• neondatabase
• node.js
• postcss
• postgresql
• radixui
• react18
• reacthookform
• recharts
• tailwindcss
• tanstackquery
• tsx
• typescript
• vite
• wouter