https://github.com/abrahamebij/fallax

Fallax is a modern phishing detection web app that helps users identify suspicious URLs before clicking.
https://github.com/abrahamebij/fallax

check-phishing check-phishing-email-scam-page cybersecurity deception fallax phishing

Last synced: 4 months ago
JSON representation

Fallax is a modern phishing detection web app that helps users identify suspicious URLs before clicking.

• Host: GitHub
• URL: https://github.com/abrahamebij/fallax
• Owner: abrahamebij
• Created: 2025-05-28T09:38:40.000Z (4 months ago)
• Default Branch: master
• Last Pushed: 2025-05-29T07:58:58.000Z (4 months ago)
• Last Synced: 2025-05-29T09:00:28.320Z (4 months ago)
• Topics: check-phishing, check-phishing-email-scam-page, cybersecurity, deception, fallax, phishing
• Language: TypeScript
• Homepage:
• Size: 182 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Fallax

**Deception Ends Here.**  

Fallax is a modern phishing detection web app that helps users identify suspicious URLs before clicking. It combines known threat sources with smart heuristics to flag risky links.

---

## 🚀 Features

- **URL Scanner**  

  Paste any URL to analyse it for potential phishing.

- **Detection Techniques**  

  - Blocklist matching  

  - Keyword analysis (e.g., login, bank, free)  

  - Suspicious domain patterns  

  - Title vs Google search mismatch  

- **Risk Scoring**  

  Displays a confidence score with a breakdown of findings.

- **Minimal UI**  

  Two routes for simplicity:

  - `/` – Landing page with overview and call to action

  - `/scan` – Core scanning tool

---

## 🧠 Tech Stack

- [Next.js](https://nextjs.org/) – App framework

- TypeScript (TSX) – Typed components

- Tailwind CSS – Rapid styling

- react-icons – Lightweight icons

- (Planned) Express/Edge backend for analysis logic

---

## 📁 Project Structure

```bash

fallax/

├── app/

│   ├── page.tsx         # Landing page

│   └── scan/

│       └── page.tsx     # Scanner UI

├── components/          # Shared UI components

├── lib/                 # Phishing logic (WIP)

├── public/

├── styles/

└── README.md

````

---

## 🛠️ Local Development

```bash

git clone https://github.com/abrahamebij/fallax.git

cd fallax

npm install

npm run dev

```

Open [http://localhost:3000](http://localhost:3000) to view it in your browser.

---

## 📌 Roadmap

- [ ] Backend integration for real-time checks

- [ ] Google search API for title mismatch

- [ ] User feedback or "report this site" option

- [ ] Mobile-first polish

---

## 🤝 Contributing

Pull requests are welcome! Feel free to fork and suggest improvements. Let’s make the web safer, one link at a time.

---

## 📄 License

MIT © Abraham Ebijuni