Mindful screen time reminders for social media and video sites.
A zen-inspired Chrome extension designed to help you maintain a healthy relationship with social media and video streaming platforms. It provides periodic reminders and usage statistics to encourage mindful consumption.
- Mindful Reminders: Shows a "Moment of Pause" overlay on monitored page access and periodic reminder notifications/overlays.
- Usage Tracking: Automatically tracks time spent on supported platforms.
- Mini Stopwatch: Shows elapsed time on monitored pages in the bottom-right/left corner, and can be hidden when it overlaps page UI.
- Usage Dashboard: View your daily usage statistics directly in the extension popup.
- Data Export: Export your usage data in JSON or CSV format for your own analysis.
- Privacy Focused: All data is stored locally in your browser. No data is sent to external servers.
- Customizable:
- Adjust reminder intervals (1-120 minutes).
- Toggle specific sites to monitor.
- Enable/disable the extension globally.
- YouTube (
youtube.com) - Twitter (
twitter.com) - X (
x.com) - Facebook (
facebook.com) - Instagram (
instagram.com) - TikTok (
tiktok.com) - Reddit (
reddit.com)
- Open the Releases page.
- Download the archive for your browser:
- Chromium browsers:
bonsho-<version>-chrome.zip - Firefox:
bonsho-<version>-firefox.zip
- Chromium browsers:
- Unzip
bonsho-<version>-chrome.zip. - Open
chrome://extensions(oredge://extensions). - Enable Developer mode.
- Click Load unpacked and select the extracted folder.
- Unzip
bonsho-<version>-firefox.zip. - Open
about:debugging#/runtime/this-firefox. - Click Load Temporary Add-on... and select
manifest.jsonin the extracted folder.
- Clone the repository
- Install dependencies:
pnpm install
- Start Development Server:
This will open a new Chrome instance with the extension loaded.
pnpm dev
To build the extension for production:
pnpm buildThe output will be in the .output directory.
- WXT - Web Extension Framework
- React - UI Library
- TypeScript - Type Safety