Mindful Tabz
100% Offline & Open Source

Take Control of Your Screen Time

Mindful Tabz is a premium, beautifully crafted browser extension designed for screen time management, session limiting, and smart domain blocking. Your data remains entirely local, forever.

0
Servers Connected
100%
Local Privacy
Free
Always Open Source
Mindful Tabz
Tracker Active
Today's Focus Quotient
84% Optimal
84%
Logged Active Time
youtube.com 25m / 30m limit
twitter.com 8m / 15m limit
github.com 2h 15m (unrestricted)

Crafted for Digital Well-Being

Mindful Tabz bundles all the essential tools you need to break distraction loops and optimize your focus, packed inside a stunning, zero-bloat dashboard.

Smart Limits

Set rigid daily or session limits for problematic domains. Once you hit your limit, the tab automatically locks you out until midnight.

Resource Groups

Group similar domains together (e.g. Social Media: Twitter, YouTube, Reddit) and apply a collective time budget across all of them combined.

Real-Time Stats

Watch your active screen time tick up with beautiful live-updating charts. Understand where your focus drops using interactive weekly records.

Security & Storage Flow

Completely sandboxed

Browsing Activity
Monitored
Extension Sandbox
Isolated
chrome.storage.local
Local Only

No telemetry, no tracking scripts, no external REST API endpoints. Your activity data never touches any remote servers. 100% private, 100% yours.

Privacy is Not an Option. It's a Fundamental Right.

Most screen time trackers monetize your attention by harvesting your detailed browsing habits. Mindful Tabz was created to break that cycle.

No External Servers

We maintain no databases, backend analytics engines, or external pipelines. Everything happens purely in the client sandbox of your browser.

Auditable, Clean Code

Every line of TypeScript is completely open and free to read. Build the extension directly from source if you want to be completely certain.

How to Run Locally

Mindful Tabz is designed for developer ease. Follow these simple steps to build and load the extension into your browser.

1

Clone the Repository

Grab the source code by cloning the GitHub repository:

git clone https://github.com/ShadyXV/mindful-tabz.git
2

Install Dependencies & Build

Install npm packages and trigger the Vite compiler for Chrome:

npm install && npm run build:chrome
3

Load Unpacked Extension

Open chrome://extensions/, enable Developer mode in the top right, and click Load unpacked. Select the built dist/chrome folder.

Vite Terminal
$ npm run build:chrome
vite v6.0.0 building for chrome...
✓ built chrome extension in 1.45s
Output Directory: dist/chrome/
- manifest.json (3.1KB)
- background.js (52.4KB)
- popup.html (1.2KB)
$ npm run dev:firefox
[Vite] Watcher active on Firefox Developer Sandbox...