Skip to content

Repository files navigation

Silver Shield

Silver Shield is a browser-extension-first scam warning product for older or vulnerable users and the family members who help protect them.

Scam warnings for the browser your family already uses.

Silver Shield is a Chrome/Edge-compatible Manifest V3 extension. It is intentionally practical, local-first, and limited in scope. It is not a new safe browser, not a full cybersecurity suite, and not an AI miracle product.

Current status

Silver Shield is tester-ready and has a store-preparation pack in docs/.

It includes:

  • Manifest V3 browser extension structure.
  • Popup checker for suspicious text and links.
  • Local deterministic risk scoring.
  • Page warning banner via content script.
  • Family/trusted-contact setup.
  • Trusted and blocked domain controls.
  • Local recent-check history with short previews only.
  • Onboarding with toolbar pinning guidance.
  • Demo page for safe local testing.
  • Privacy, safety, QA, tester, release, and store-prep documentation.
  • ZIP packaging command for tester builds.

What it does not do yet

  • No backend.
  • No account system.
  • No payment system.
  • No Supabase integration.
  • No external AI/API calls.
  • No telemetry.
  • No real contact messaging.
  • No Safari/iPhone build yet.
  • No guarantee that a page or message is safe or unsafe.

Silver Shield can make mistakes. When in doubt, ask someone you trust or contact the organisation directly using a known official route.

Project structure

src/
  background/
  content/
  onboarding/
  options/
  popup/
  shared/

demo/
docs/
scripts/
assets/brand/
public/icons/

manifest.json
package.json
tsconfig.json
README.md
PRIVACY.md
SAFETY.md
CHANGELOG.md

Brand assets

Recommended local brand files:

assets/brand/silver-shield-icon.png
assets/brand/onboarding-hero.png

Optional exact-size extension icons:

assets/brand/icons/icon-16.png
assets/brand/icons/icon-32.png
assets/brand/icons/icon-48.png
assets/brand/icons/icon-128.png

The build script uses the exact-size icons if present, otherwise it uses silver-shield-icon.png, otherwise it falls back to a placeholder icon.

Install locally in Chrome or Edge

npm install
npm run build

Then:

  1. Open chrome://extensions or edge://extensions.
  2. Enable Developer Mode.
  3. Choose Load unpacked.
  4. Select the generated dist folder.
  5. Pin Silver Shield to the browser toolbar.

Development commands

npm install
npm run build
npm run test:rules
npm run package

npm run package creates:

packages/silver-shield-extension-v0.1.0.zip

Privacy model

Silver Shield v0.1.0 is local-only:

  • Checks run in the browser.
  • No backend is required.
  • No telemetry is collected.
  • No account is required.
  • Settings are stored with chrome.storage.local.
  • Recent history stores short previews only.
  • Trusted contact details and domain lists are stored locally only.

Future AI checking would require explicit consent and a separate privacy design.

Core documentation

  • PRIVACY.md — local-only privacy model.
  • SAFETY.md — safety wording, limits, and emergency guidance.
  • CHANGELOG.md — release history.
  • docs/QA.md — manual QA checklist.
  • docs/TESTER_GUIDE.md — guide for non-technical testers.
  • docs/family-safety-checklist.html — printable family checklist.

Store-preparation documentation

  • docs/STORE_SUBMISSION.md — store submission guide.
  • docs/STORE_LISTING_COPY.md — ready-to-copy store listing text.
  • docs/STORE_PRIVACY_ANSWERS.md — privacy and data-use answer drafts.
  • docs/STORE_ASSETS.md — store asset checklist.
  • docs/SCREENSHOT_PLAN.md — screenshot capture plan.
  • docs/RELEASE_CHECKLIST.md — final release checklist.
  • docs/store-privacy-policy.html — privacy policy page template.
  • docs/support.html — support page template.

Store-readiness notes

Before public store submission:

  1. Run the full release checklist in docs/RELEASE_CHECKLIST.md.
  2. Capture screenshots using docs/SCREENSHOT_PLAN.md.
  3. Prepare final store graphics using docs/STORE_ASSETS.md.
  4. Host the privacy and support pages publicly.
  5. Confirm the latest Chrome Web Store and Microsoft Edge Add-ons dashboard requirements.
  6. Upload the ZIP generated by npm run package.

Use careful wording: Silver Shield shows warning signs and helps users pause before acting. It must not claim guaranteed protection.

Roadmap

Phase 1

Chrome/Edge desktop extension MVP with onboarding and local trusted-contact setup.

Phase 1.5

Demo page, stronger UK rules, trusted/blocked domain controls, and per-site banner dismissal.

Phase 1.9

Tester-ready package with privacy docs, safety docs, manual QA, tester guide, printable checklist, and ZIP packaging.

Phase 1.95

Store-prep materials: listing copy, privacy answers, screenshot plan, release checklist, hosted privacy/support page templates.

Phase 2

Better rule engine, allowlist/blocklist refinement, stronger suspicious-domain detection, and a proper family contact workflow.

Phase 3

Optional consent-based AI checker with privacy-preserving design and clear user controls.

Phase 4

Safari Web Extension conversion and Apple-compatible companion app.

Phase 5

iPhone/iPad family setup flow.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages