SimGuardian

Overview

SimGuardian is a mobile security platform designed to protect users from SIM swap fraud, unauthorized device access, and identity theft. Built with a focus on user security and real-time alerts, SimGuardian ensures that your mobile identity remains safe.

Features

• SIM Swap Protection: Get notified when suspicious activity related to your SIM card is detected.

• Device Management: Easily manage and track registered devices connected to your account.

• Scam Reporting: Report fraudulent numbers and scams to a centralized community-driven database.

• Real-time Notifications: Receive SMS alerts for account activities (supports Airtel, with Safaricom integration pending).

• User Authentication: Secure login and account verification powered by Supabase.

Tech Stack

This project is built using:

• Frontend: React (Vite, TypeScript, Tailwind CSS, ShadCN UI)

• Backend: Supabase (PostgreSQL, Authentication)

• Messaging API: Africa’s Talking (for SMS notifications)

Getting Started

Prerequisites

Ensure you have the following installed:

• Node.js & npm - install with nvm

• Git (for cloning the repository)

The only requirement is having Node.js & npm installed - Follow these steps:

# Step 1: Clone the repository using the project's Git URL.
git clone <THIS_GITHUB_URL>

# Step 2: Navigate to the project directory.
cd <PROJECT_DIRECTORY_NAME>

# Step 3: Install the necessary dependencies.
npm install

# Step 4: Start the development server
npm run dev

Contributing

If you’d like to contribute to SimGuardian, feel free to fork the repository and submit a pull request with your improvements.

Future Improvements

• Safaricom API Integration for wider SMS support.

• AI-powered Scam Detection for detecting and blocking fraudulent activity.

• User Dashboard Enhancements for a better experience.

Contact

For questions or collaboration, reach out via GitHub Issues or email me at muthokaelikeli@gmail.com or message me on LinkedIn Eli Keli