Submission for UW Saves The World Hackathon – April 27, 2025

KnowIt is a Chrome extension frontend that helps users quickly assess the reliability of web articles and detect potential phishing in Gmail. This repo contains only the UI and client-side logic.

• Project Overview
• Features
• Demo Screenshots
• Tech Stack
• Installation & Setup
• Usage
• Future Work
• Contributing
• License

During the UW Saves The World Hackathon, we built KnowIt, a Chrome extension that empowers readers to:

1. Evaluate article reliability with a clear score and alternative sources.
2. Detect phishing in Gmail messages before clicking any links.

This frontend repository contains the popup UI, styling, and Chrome-extension wiring.

• Article Reliability
  • Scrapes page content, sends it to a backend evaluator, and displays a reliability percentage.
  • Offers links to alternative, credible articles.
• Gmail Phishing Detection
  • Reveals a “Check email for phishing” button only on mail.google.com.
  • Displays a color-coded score and explanation when phishing is suspected.

(Replace these placeholders with real screenshots in Assets/.)

• HTML5 / CSS3 – Popup markup & theming (light & dark modes)
• JavaScript (ES6) – DOM manipulation, theme toggle, fetch API
• Chrome Extension Manifest V3 – Permissions, scripting, popup integration

1. Clone this repo

   git clone https://github.com/yourorg/KnowIt-Frontend.git
   
   2.	Open Chrome → chrome://extensions/
   3.	Enable Developer mode (top right)
   4.	Click Load unpacked → select this project folder
   5.	Pin the KnowIt extension to your toolbar
   

• On any article page:
  1. Click the KnowIt icon.
  2. View the reliability score and alternative links.
• In Gmail:
  1. Open an email.
  2. Click “Check email for phishing.”
  3. See a colored score ring and explanation.

• Real-time background phishing detection without manual click
• Enhanced reliability dashboard with source citations
• User-customizable thresholds and notifications
• Cross-browser support (Firefox, Edge)

We welcome bug reports, feature requests, and pull requests. Please fork, branch, and submit a PR.

This project is released under the MIT License. See LICENSE for details.