Form Recovery

📝 **Form Recovery** — Never lose your form input again.

Form Recovery is a lightweight, privacy-respecting Chrome extension that automatically saves your typed form data in real-time — so if the page crashes, reloads, or you accidentally close a tab, your work isn't lost.

---

## 🚀 Features

✅ **Auto-save input every few seconds**
Form Recovery detects when you're typing and silently saves form data every 10 seconds if any changes are detected.

📂 **Organized by website & timestamp**
Entries are grouped by URL and saved with a timestamp so you can easily go back to the right version.

⚡ **Quick Inject button**
Restore all your saved data with a single click. The extension finds the matching fields and re-populates them automatically.

🧠 **Smart field recognition**
Supports `input`, `textarea`, and even `contenteditable` fields like those used in rich-text editors or chat boxes.

📋 **Manual copy fallback for tricky sites**
On platforms like Facebook that use complex DOM structures or restrict form interaction, Form Recovery provides a clean copy interface with per-field copy buttons. A message alerts you if automatic injection isn’t possible.

🖱️ **Right-click recovery**
Right-click anywhere on a webpage and select **"Recover Form Data"** to open a popup recovery window showing all past entries for that page.

🧼 **Automatic cleanup**
Old entries are automatically removed after 30 days to keep things tidy.

🔐 **No syncing, no accounts, no cloud**
Everything is stored locally on your device. Your data never leaves your browser.

---

## 🧩 Use Cases

- Filling out long feedback or contact forms
- Writing comments or posts on social media
- College/job applications that time out
- Accidentally closing a tab with unsent input
- Working in single-page apps that crash or reset content

---

## 🎯 How to Use

1. Just browse and type as normal — the extension runs silently in the background.
2. If you need to recover something:
- Click the extension icon to view all saved form entries.
- Or right-click the page and select **Recover Form Data**.
3. Use **Quick Inject** to repopulate fields or **Copy** buttons to paste values manually.

---

## 🔒 Privacy & Security

Form Recovery is built with **privacy first**:
- Your form data is stored **locally** using `chrome.storage.local`.
- We do **not** transmit or collect any personal data.
- We do **not** use analytics, trackers, or third-party libraries.
- You stay completely in control.

📌 You do **not** need to create an account or log in to use this extension.

---

## 🖼️ Screenshots

*(Upload screenshots in the dashboard showing:)*
- The popup with saved entries
- The recovery page with quick inject
- A Facebook fallback message and copy buttons
- Example of a restored form

---

## 🧰 Permissions

- `storage` – To save and retrieve your form entries
- `activeTab`, `tabs` – To detect the current tab for injecting data
- `scripting` – To auto-fill forms on request
- `contextMenus` – To add the right-click "Recover Form Data" option
- `<all_urls>` – So it can detect and save form input on any site

These permissions are **only used locally** and solely to provide the extension's core features.

---

## ❓ FAQ

### Does it sync between devices?
No — all form data is saved only on your device. This ensures privacy and simplicity.

### Will it work on every site?
It works on nearly all sites. However, some complex platforms like Facebook use non-standard input fields or block script injection. In those cases, the extension provides a message and copy buttons so you can manually recover your data.

### How long is data saved?
Saved entries are automatically deleted after 30 days.

---

## 🛠️ Developer Notes

Form Recovery was designed to solve a simple but annoying problem — losing unsent text in forms when the page reloads, crashes, or is closed accidentally. It's meant to be lightweight, local-first, and focused on solving one problem well.

If you have feedback, bugs, or feature suggestions, you’re welcome to reach out or contribute!

---

## ✅ Summary

Form Recovery is your safety net for online forms.
Never retype a long message, form, or comment again.

---

**Created by:** Kevin Aspden
Version: 1.0
Platform: Chrome Extension