Skip to content
View scam-sentry's full-sized avatar

Block or report scam-sentry

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
Scam-Sentry/README.md

Scam Sentry πŸ›‘οΈ

A free, anonymous Android scam awareness app built with Flutter.

Available on Google Play: https://play.google.com/store/apps/details?id=uk.co.scamsentry.app


What it does

Scam Sentry helps people check whether a situation they are experiencing matches known scam patterns. Select a category, answer nine yes/no questions, and receive a personalised risk result explaining exactly which warning signs were present and why, with clear next steps and direct links to official UK and US reporting resources.

Six categories covered:

  • Romance scams β€” including sextortion warning signs
  • Investment and crypto scams β€” fake platforms, guaranteed-return promises
  • Phishing and bank impersonation β€” fake fraud team calls, OTP scams
  • Purchase scams β€” fake listings, sellers who disappear after payment
  • Job scams β€” including money muling and pyramid schemes
  • High-risk activity β€” for situations that don't fit a specific category

Key features:

  • Personalised results β€” explains exactly which answers raised concern and why
  • Per-question info dialogs β€” explains why each specific thing matters and what to do right now
  • Share result β€” send a summary to a trusted friend or family member in one tap
  • UK and US support resource tabs with direct links to official reporting bodies
  • Dark mode β€” follows device display setting automatically
  • Privacy policy built into the app β€” no external sites

Privacy first:

  • No account or login required
  • Answers never leave the device
  • No IP address, location, or device tracking
  • No ads, no in-app purchases

Built with

Built collaboratively using Claude (Anthropic) and Grok as AI development partners, with all logic, question content, and risk scoring decisions directed and reviewed by the developer.


Getting started

Prerequisites

  • Flutter SDK 3.x
  • Android SDK
  • A Firebase project (for Crashlytics)
  • An Amplitude account (EU server)

Setup

  1. Clone the repo
git clone https://github.com/scam-sentry/Scam-Sentry.git
cd scam-sentry
  1. Install dependencies
flutter pub get
  1. Configure Firebase Run flutterfire configure to generate your own firebase_options.dart

  2. Run the app

flutter run --dart-define=AMPLITUDE_KEY=your_amplitude_key_here

Project structure

lib/ β”œβ”€β”€ main.dart β€” app entry, dual theme (light/dark) β”œβ”€β”€ services/ β”‚ β”œβ”€β”€ analytics_service.dart β€” Amplitude wrapper β”‚ └── email_service.dart β€” mailto launcher β”œβ”€β”€ widgets/ β”‚ β”œβ”€β”€ bold_text.dart β€” markdown bold renderer β”‚ └── responsive_body.dart β€” max-width tablet support β”œβ”€β”€ theme/ β”‚ β”œβ”€β”€ app_colors.dart β€” navy/gold palette, dark mode variants β”‚ └── text_styles.dart β€” centralised text styles β”œβ”€β”€ screens/ β”‚ β”œβ”€β”€ home_screen.dart β”‚ β”œβ”€β”€ category_screen.dart β”‚ β”œβ”€β”€ question_screen.dart β€” 54 per-question info entries β”‚ β”œβ”€β”€ result_screen.dart β€” risk logic, share button β”‚ β”œβ”€β”€ info_screen.dart β€” FAQ, privacy policy dialog β”‚ β”œβ”€β”€ support_screen.dart β€” UK/US tab switcher β”‚ └── quick_tips_screen.dart └── questions/ β”œβ”€β”€ romance_questions_screen.dart β”œβ”€β”€ investment_questions_screen.dart β”œβ”€β”€ phishing_questions_screen.dart β”œβ”€β”€ purchase_questions_screen.dart β”œβ”€β”€ job_questions_screen.dart └── high_risk_questions_screen.dart


Notes

  • Android only β€” no iOS support currently
  • firebase_options.dart, google-services.json, android/key.properties, and firebase.json are gitignored β€” you will need to configure these yourself
  • Amplitude API key is passed via --dart-define at build time and is never hardcoded

Licence

This project is provided for reference and educational purposes. All rights reserved.


Scam Sentry is an independent tool and is not affiliated with any bank, police force, or government body.

Any questions please feel free to reach out: support@scam-sentry.co.uk

Linkedin: www.linkedin.com/in/geowil

Popular repositories Loading

  1. Scam-Sentry Scam-Sentry Public

    Scam awareness app, contains 6 distinct categories with each consisting of 9 yes/no questions. The results can vary between low/medium/high risk depending on what the user selects.

    Dart 1