Once

Once is a Chrome extension that limits your visits to distracting websites to once per hour. Instead of blocking sites entirely, Once lets you visit them — but only once an hour, helping you stay productive without going cold turkey.

How it works

1. Pick the websites that waste your time (Reddit, X, YouTube, etc.)
2. Visit one of those sites and Once starts a one-hour timer
3. If you try to visit the same site again within the hour, Once blocks it and shows you how much time is left

Install

Get Once on the Chrome Web Store

Development

Prerequisites

• Node.js >= 18

Setup

git clone https://github.com/YoucefHQ/Once.git
cd Once
npm install

Run in development

npm start

This builds the extension, launches Chrome with it loaded, and opens the options page automatically. esbuild watches for file changes and rebuilds — reload the extension at chrome://extensions to pick up updates.

Run tests

npm test

Tests use Puppeteer to launch Chrome with the extension loaded and verify the options page, onboarding flow, and site blocking.

Build for production

npm run build

The build folder will contain the extension ready for the Chrome Web Store.

Tech stack

• React 19
• TypeScript 5
• esbuild
• Chrome Extension Manifest V3

License

MIT