SecureScan

A modern, secure, and ephemeral QR-code generator platform.
Send self-destructing text messages or images through beautifully styled QR codes.

Features

• ** Ephemeral Images:** Uploaded images automatically expire and are securely deleted after exactly 120 seconds.
• ** Quick Share:** Generate high-quality QR codes instantly and share them directly to WhatsApp or save them to your device.
• ** Modern UI:** A premium, responsive interface featuring dynamic animations using Framer Motion and GSAP.
• ** Automated Garbage Collection:** A built-in Node-Cron worker continuously checks and cleans up expired assets from the Supabase database and storage buckets.
• ** Next.js 14 App Router:** Built for speed, utilizing modern server and client components.

---

Quick Start

1. Clone the repository

git clone https://github.com/lavjeetrai/SecureScan.git
cd SecureScan

2. Install dependencies

npm install

3. Environment Setup

Create a .env.local file in the root of the project and add your Supabase credentials.

SUPABASE_URL=https://your-project.supabase.co
SUPABASE_SERVICE_ROLE_KEY=your_service_role_key_here
SUPABASE_BUCKET_NAME=securescan

Note: The SERVICE_ROLE_KEY is required because the backend garbage collector needs privileges to bypass Row Level Security and delete expired images. Ensure your bucket is created in Supabase Storage!

4. Running the Application

This project requires two terminals to run fully: the frontend web server and the background garbage collection worker.

Terminal 1 (Web Server):

npm run dev

Terminal 2 (Garbage Collector Worker):

npm run worker

Open http://localhost:3000 with your browser to start generating secure QR codes!

---

Tech Stack

• Frontend: Next.js 14, React 18, TailwindCSS, Framer Motion, GSAP, Radix UI, Shadcn/UI
• Backend: Next.js Route Handlers
• Database & Storage: Supabase Postgres & Supabase Storage API
• Utilities: Node-Cron, QRCode.react

---

📝 License

This project is open-source and available under the MIT License.