Back to Portfolio

Darrell's ReLoader

Firefox & Chrome Browser Extension — Automated tab refreshing on fully customizable intervals

v1.2.0 — Live on Firefox & Chrome
Firefox Add-ons Chrome Web Store

Overview

Darrell's ReLoader is a published browser extension — available on both the Firefox Add-ons store and the Chrome Web Store — that automates tab refreshing on user-defined intervals. It was built to solve a specific, practical need: monitoring pages that don't auto-update, dashboards, queues, or any live content where manual refreshing becomes tedious.

The extension is lightweight (21KB), privacy-respecting (zero data collection), and handles edge cases that simpler implementations miss — including safety guards against firing on browser system pages, persistence across restarts, and content-script-based timers that allow intervals as short as 5 seconds without hitting background script throttling limits.

v1.2.0
Version
21 KB
Package Size
MIT
License
Live
Status

Tech Stack

Built entirely with standard WebExtension APIs — no frameworks, no dependencies, no build step. Published on both Firefox and Chrome.

JavaScript (ES6+)
Extension Logic
WebExtension API
Browser Integration
Content Scripts
Tab-level Timer Injection
Background Scripts
Session Coordination
localStorage
Settings Persistence
Manifest V2 / V3
Firefox / Chrome Manifests
HTML / CSS
Popup UI
Firefox Add-ons & Chrome Web Store
Distribution

Key Features

Customizable Intervals

  • User-defined refresh timing from 5 seconds upward
  • No arbitrary upper limit — works for long-polling workflows
  • Simple numeric input — enter seconds and start

Session Persistence

  • Settings survive browser restarts
  • State preserved across popup open/close cycles
  • localStorage used for lightweight, dependency-free persistence

Visual Status Indicators

  • Toolbar icon turns green when active, red when inactive
  • Status visible at a glance without opening the popup
  • No ambiguity about whether reloading is running

Safety Guards

  • Blocked from executing on system pages (about:, moz-extension://, chrome-extension://)
  • Prevents crashes or undefined behavior on privileged URLs
  • Graceful no-op on restricted tab types

Lightweight Architecture

  • 21KB total package — no bundler, no framework overhead
  • Content-script timers allow short intervals without background throttling
  • Zero external dependencies

Privacy First

  • No data collected, transmitted, or shared
  • Everything stays on the user's device
  • Published under MIT license — fully open

Technical Highlights

Content-Script Timer Architecture

Rather than running the reload timer in the background script, the extension injects timers via content scripts into the active tab. This sidesteps Firefox's background script throttling, which becomes aggressive at short intervals, and allows reliable sub-10-second reloads. The background script handles coordination and state — the content script handles execution.

System Page Safety Guards

Firefox extensions can behave unexpectedly or crash when they attempt to run on privileged URLs like about:blank, about:newtab, or moz-extension://. The extension checks the active tab's URL before injecting any content script or attempting a reload, silently no-opping on restricted pages rather than throwing errors.

Persistent State Across Restarts

The extension uses localStorage to persist the user's configured interval and active/inactive state. When the browser restarts or the popup is reopened, the previous settings are restored immediately — the user doesn't need to re-enter their interval each time. This required careful handling of the extension lifecycle, particularly coordinating state between the popup context and the background script context.

Published on Firefox Add-ons & Chrome Web Store

The extension passed Mozilla's full review and signing process for Firefox, and separately passed Google's review for the Chrome Web Store — each with their own policy requirements, manifest format (V2 for Firefox, V3 for Chrome), and permission justification process. Both stores have automated and manual security review stages. The result is a cross-browser extension installable by any Firefox or Chrome user directly from their respective store.

What This Project Demonstrates

Browser Extension Development
WebExtension APIs, manifest configuration, content scripts, background scripts, and popup UI
Event-Driven Architecture
Coordinating state and behavior across popup, background, and content script execution contexts
Published Software Distribution
Passed both Mozilla and Google's review processes — publicly listed on Firefox Add-ons and the Chrome Web Store
Edge Case Handling
System page guards, browser throttling workarounds, and lifecycle state coordination
Privacy-Respecting Design
Zero data collection, minimal permissions, and fully transparent MIT-licensed source
Lightweight Engineering
21KB with no dependencies — solving a real problem with the minimum viable complexity

Try It in Your Browser

Free, open source, and available on both Firefox and Chrome.

Firefox Add-ons Chrome Web Store Get In Touch