https://github.com/dibyadyutidas/digital_detox
Helps users reduce screen time and overcome phone addiction habits
https://github.com/dibyadyutidas/digital_detox
app github
Last synced: 12 months ago
JSON representation
Helps users reduce screen time and overcome phone addiction habits
- Host: GitHub
- URL: https://github.com/dibyadyutidas/digital_detox
- Owner: DibyadyutiDas
- License: mit
- Created: 2025-04-09T02:25:38.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-28T11:37:18.000Z (about 1 year ago)
- Last Synced: 2025-05-28T12:35:22.531Z (about 1 year ago)
- Topics: app, github
- Homepage: https://dibyadyutidas.github.io/Digital_Detox/
- Size: 21.5 KB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 📵 Digital Detox – Quit Mobile Addiction Smartly
A mindful, data-driven app to help users take control of their screen time, break mobile addiction, and build healthier offline habits.
---
## 🚀 Overview
**Digital Detox** is your personal digital wellbeing assistant. It tracks your mobile usage, sends intelligent nudges, and helps you stick to focus routines through gamification and challenge-based detox programs. Whether you're a student, professional, or just tired of endless scrolling – this app is built for you.
---
## 🎯 Features
- 📊 **Screen Time Dashboard**
Track your daily, weekly, and monthly phone usage with beautiful visual charts.
- ⏰ **Smart Reminders & Nudges**
Get notified when you're overusing an app or falling back into old habits.
- 🔒 **Focus Mode**
Block distracting apps during study, work, or sleep hours. Customize your routine.
- 🧠 **Emergency Unlock Reasoning**
Force yourself to pause and explain why you need to unlock a blocked app.
- 🎖️ **Gamified Detox Challenges**
Join 7-day or 21-day challenges, earn badges, level up, and celebrate your progress.
- 🧘 **Offline Activity Suggestions**
Engage in real-world tasks like reading, journaling, or going for a walk.
- 🔐 **Privacy-First**
All data stays local unless you choose to back it up. No ads. No data selling. Ever.
---
## 📸 Preview
> Add screenshots or demo GIFs here once your UI is ready!
---
## 🛠️ Tech Stack
| Component | Technology |
|------------------|--------------------|
| Frontend | Flutter / React Native |
| Backend (optional) | Firebase / Node.js / SQLite |
| Analytics | Chart.js / D3.js |
| APIs | Android Usage Stats API, Health APIs |
| Authentication | Google Auth (optional) |
---
## 🧪 Setup Instructions
1. Clone the repo:
```bash
git clone https://github.com/DibyadyutiDas/digital-detox.git
cd digital-detox
```
2. Install dependencies:
```bash
npm install
# or
flutter pub get
```
3. Run the app:
```bash
npm run start
# or
flutter run
```
---
## 🎯 Roadmap
- ✅ Screen time tracker
- ✅ Focus mode
- 🔄 Emergency unlock reasoning *(in progress)*
- 🔜 Detox challenges with leaderboard
- 🔜 AI chatbot for habit coaching
- 🔜 Community features
---
## 🧠 Inspiration
- My own struggles with mobile addiction.
- Friends who want to reduce screen time but fail due to lack of motivation.
- The urgent need to reclaim focus, sleep, and peace of mind in the digital age.
---
## 📜 License
This project is open source under the [MIT License](LICENSE).
---
## 🤝 Contributing
PRs, ideas, feedback – all are welcome!
Open an issue or fork the repo and make your own changes.
---
## 🙌 Acknowledgements
- [Google Digital Wellbeing](https://wellbeing.google/)
- *"Digital Minimalism"* by Cal Newport
- Every user who’s trying to live more intentionally ✨
---
> _"Control your phone, before it controls you." – Digital Detox_