QRGuard: Secure QR Code Scanner

Open Source

This project is open source and you are free to modify and use it for your own cybersecurity projects. This can be a great way to learn and to build your portfolio, which can help you get a job as a fresher.

If you like this project, please give us a star on GitHub, share our app on the Play Store, and follow us for more updates.

QRGuard AI – Scan Smart. Stay Safe. QRGuard AI is your intelligent companion for scanning QR codes safely and securely. With the increasing risk of malicious QR codes being used for phishing or fraud, QRGuard AI helps you scan with confidence by detecting and warning you of suspicious links, redirects, and unsafe domains before you open them.

⚙️ Key Features:

✅ AI-Powered Security: Detects and warns about suspicious QR codes in real-time.

📱 Lightweight and Fast: Designed for quick scans without draining your battery.

🌐 URL Analyzer: Checks URLs for threats using Google Safe Browsing API, smart logic, and threat intelligence.

🔒 Privacy-First: No tracking. Your scan history stays on your device.

📡 Offline Scan Support: Works even when you're offline (basic scan).

🌙 Dark Mode Supported: Beautiful interface that adapts to your theme.

🌟 Perfect for:

• Cybersecurity-conscious users
• Parents, teachers, and students
• Corporate and field workers
• Anyone who uses QR codes frequently

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Prerequisites

• Node.js (v18 or newer)

• npm

• Expo Go app on your mobile device or an Android/iOS emulator. You can download it from the App Store or Google Play.

  

Installation

This project is maintained by codesec.

1. Clone the repository:

   git clone https://github.com/altafpasha/qrguard-ce.git
   cd QRGuard-bolt

2. Install dependencies:

   npm install

3. Set up environment variables: Create a .env file in the root of the project and add the necessary environment variables. You can use the .env.example file as a template.

   cp .env.example .env

   Then, fill in the required values in the .env file.

   API Keys and URLs

   • EXPO_PUBLIC_GOOGLE_SAFE_BROWSING_API_KEY: Your Google Safe Browsing API key. You can get one from the Google Cloud Console.
   • EXPO_PUBLIC_GEMINI_API_KEY: Your Google Gemini API key. You can get one from Google AI Studio.
   • EXPO_PUBLIC_QR_DECODE_API_URL: The URL for your self-hosted QR code decoder API. You can deploy your own using this repository: https://github.com/altafpasha/QR-Decoder-api.git
   • EXPO_PUBLIC_QR_DECODE_API_KEY: The API key for your self-hosted QR code decoder API, if you have configured one.
   • EXPO_PUBLIC_SUPABASE_URL: Your Supabase project URL.
   • EXPO_PUBLIC_SUPABASE_ANON_KEY: Your Supabase project anon key.

Usage

1. Start the development server:

   npm run dev

   or

   npm run dev -- --clear

2. Run on your device: Scan the QR code generated in the terminal with the Expo Go app on your phone, or press a for Android emulator or i for iOS simulator.

Contributing

Contributions are welcome! Please feel free to submit a pull request or open an issue to discuss any changes.

License

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

Please Note: You are free to modify and distribute this code. However, you are not permitted to use this application or its source code for any commercial purposes or for earning money.

Customization

You can customize the application by modifying the app.config.js file. Here are some of the things you can change:

• name: The name of the application.
• slug: The slug of the application.
• version: The version of the application.
• orientation: The orientation of the application.
• icon: The icon of the application.
• splash: The splash screen of the application.
• android.package: The package name of the Android application.

For more information on how to configure the app.config.js file, please refer to the Expo documentation.