Auto Refresh Pro — Modern Auto-Refresher EN

# 🔄 Auto Refresh Pro

A modern, beautiful auto-refresh extension for **Chrome (Manifest V3)** with a
popup, a full-page settings dashboard, a side-panel control center and **100+ features**.


---

## ✨ Highlights

- **Per-tab auto refresh** — start/stop/refresh-now from the popup, side panel,
right-click menu, or keyboard (`Alt+R`).
- **Modern UI everywhere** — glassmorphism, 6 themes, accent color picker,
compact mode, animations.
- **Popup** — interval stepper, presets (5s→1h), live countdown, progress bar,
session stats, quick actions (copy URL, screenshot, mute, pin…).
- **Side panel** — live dashboard: stats, 24h activity chart, per-tab table
with search, bulk start/stop/refresh, URL manager, refresh history log
(export as JSON), schedule editor.
- **Full-page settings** — 11 tabs covering scheduling, rules engine,
notifications, sounds, badge, after-refresh actions, appearance, advanced.
- **Intelligent scheduling** — time window, days-of-week, overnight windows.
- **Rules engine** — allow/block patterns with wildcards.
- **Smart behaviour** — auto-stop on keyword/title, auto-click selector,
auto-scroll, custom JS after every load, offline-aware, active-tab-only,
randomized intervals, hard reload (bypass cache), error-page auto-reload.
- **100% local & private** — no servers, no tracking.

See **[FEATURES.md](FEATURES.md)** for the complete numbered list.

---

## 📦 Install (Developer Mode)

1. Make sure the `auto-refresh-pro` folder is on your disk (it already is).
2. Open Chrome and go to `chrome://extensions`.
3. Enable **Developer mode** (toggle, top-right).
4. Click **Load unpacked** → select the **`auto-refresh-pro`** folder.
5. Pin the extension for easy access.

That's it — you're running.

---

## ⌨️ Keyboard shortcuts

| Action | Keys |
| --------------------------------------- | --------------- |
| Toggle auto refresh on the current tab | `Alt + R` |
| Refresh current tab now | `Alt + Shift + R` |

Customize them at `chrome://extensions/shortcuts`.

---

## 🖱 Right-click quick menu

- **Auto-refresh this tab**
- **Stop auto-refresh**
- **Refresh now**
- Fast presets: **every 5s / 30s / 60s**
- **Open Auto Refresh Pro — Settings**

---

## 🗂 Project layout

```
auto-refresh-pro/
├─ manifest.json # MV3 manifest (side panel, permissions, commands)
├─ background.js # Service worker: refresh engine, scheduler, badge,
│ # notifications, context menus, message hub
├─ lib/common.js # Shared library (storage, rules, schedule, helpers)
├─ content/content.js # In-page actions (auto-click, scroll, script, errors)
├─ popup/ # Popup UI (HTML/CSS/JS)
├─ sidepanel/ # Side-panel control center (HTML/CSS/JS)
├─ settings/ # Full-page settings dashboard (HTML/CSS/JS)
├─ assets/ui.css # Shared modern design system
├─ assets/icons/ # Generated brand icons (16–128 px)
└─ FEATURES.md # 100+ feature list
```

---

## 🧪 Tests

Core logic (rules, scheduling, formatting, storage round-trip) is covered by
`test_logic.js` — run with `node test_logic.js` (32 assertions).

---

## 💡 Tips

- Use **hard reload** for pages that cache aggressively.
- Use the **rules engine** to block refresh on pages that must not reload.
- **Randomize interval** to look more human on live-tracking sites.
- Set an **auto-stop keyword** (e.g. "In Stock") to stop when the page changes.
- Check the **logo badge** — it shows a live countdown per refreshing tab.