Our Portfolio

LedgerFlow is a modern AI‑powered personal finance management platform designed to help individuals take control of their financial life with simplicity and intelligence

This is a Node.js‑based WhatsApp marketing automation platform designed to help businesses and marketers send bulk messages and media to WhatsApp contacts efficiently.

<h3><strong>Description:</strong></h3><p>This tool is a <strong>powerful Node.js &amp; Puppeteer-based scraper</strong> that automates the extraction of business data from Google Maps. It allows users to provide <strong>keywords, locations, or geolocation coordinates</strong> and retrieves structured business information including <strong>names, addresses, phone numbers, websites, and distances</strong> within a specified radius.</p><p>Designed for marketers, researchers, or businesses needing <strong>bulk business data</strong>, the scraper supports <strong>real-time progress updates</strong>, <strong>duplicate filtering</strong>, and <strong>invalid data handling</strong>, ensuring reliable and efficient data collection.</p><hr><h3><strong>Functionalities:</strong></h3><ul><li><p>🔍 <strong>Keyword &amp; Location Search</strong> – Input any keyword and a location or use live geolocation to target specific areas.</p></li><li><p>🏢 <strong>Business Data Extraction</strong> – Scrapes <strong>name, phone number, website, address</strong>, and calculates <strong>distance</strong> from a given point.</p></li><li><p>📏 <strong>Radius Filtering</strong> – Only returns businesses within a specified radius in meters/kilometers.</p></li><li><p>🔁 <strong>Duplicate Handling</strong> – Automatically detects and skips duplicate entries.</p></li><li><p>🚫 <strong>Invalid Data Filtering</strong> – Skips entries with missing or malformed addresses.</p></li><li><p>📡 <strong>Real-Time Streaming</strong> – Uses <strong>Server-Sent Events (SSE)</strong> to stream progress and results live to the client.</p></li><li><p>🧭 <strong>Geocoding &amp; Distance Calculation</strong> – Converts locations to coordinates and calculates distances using <strong>Node-Geocoder</strong> + <strong>Geolib</strong>.</p></li><li><p>🗄️ <strong>Caching</strong> – Stores geocoding results with <strong>Node-Cache</strong> for 24 hours to speed up repeated searches.</p></li><li><p>⚙️ <strong>Error Handling &amp; Logging</strong> – Detailed logs for debugging, automatic screenshots on scraping errors.</p></li><li><p>🖥️ <strong>Headless Browser Automation</strong> – Puppeteer navigates Google Maps, scrolls listings, and extracts relevant data efficiently.</p></li></ul><hr><h3><strong>Technology Stack:</strong></h3><p><strong>Frontend / Client:</strong></p><ul><li><p>⚛️ <strong>React.js</strong> – Dynamic user interface (<code>maps-scraper-client/src/App.js</code>)</p></li><li><p>🌐 <strong>HTML5 &amp; CSS3</strong> – Public pages (<code>index.html</code>, <code>styles.css</code>)</p></li><li><p>🖥️ <strong>JavaScript</strong> – Client-side logic (<code>script.js</code>)</p></li><li><p>🔄 <strong>Server-Sent Events (SSE)</strong> – Real-time log &amp; data streaming to the browser</p></li></ul><p><strong>Backend / Scraper Engine:</strong></p><ul><li><p>🟢 <strong>Node.js</strong> with <strong>Express.js</strong> – API endpoints (<code>/api/scrape</code>, <code>/api/scrape-stream</code>)</p></li><li><p>🤖 <strong>Puppeteer</strong> – Automated browser for Google Maps navigation &amp; scraping</p></li><li><p>🗺️ <strong>Node-Geocoder</strong> + <strong>LocationIQ API</strong> – Converts typed locations into latitude/longitude</p></li><li><p>📏 <strong>Geolib</strong> – Distance calculations between user location and businesses</p></li><li><p>🗄️ <strong>Node-Cache</strong> – Stores geocoding results for repeated searches</p></li><li><p>🌐 </p></li><li><p> – Handles API requests safely</p></li></ul><p><strong>Additional Tools / Features:</strong></p><ul><li><p>📂 Automatic scrolling &amp; panel handling to extract all visible businesses</p></li><li><p>🔄 Deduplication &amp; invalid address skipping for cleaner datasets</p></li><li><p>📸 Automatic screenshots for debugging failures</p></li><li><p>⏱️ Configurable maximum results &amp; timeout handling</p></li></ul><hr>

A modern business website developed for an internet service provider offering fiber, CAT6, and wireless broadband connections across Lahore with online connection request functionality.

<h3>Description:</h3><p>This project is a <strong>real-time customer support chat system</strong> built with <strong>Flask and WebSocket technology</strong>, allowing users to communicate instantly with administrators through a secure messaging interface. The platform includes <strong>separate user and admin dashboards</strong>, encrypted messaging, file sharing, and session management to ensure smooth and secure communication.</p><p>The system is designed for <strong>business websites that require live customer support</strong>, enabling administrators to manage conversations, respond to users in real time, and receive notifications when new chat sessions are created.</p><hr><h1>⚙️ Core Functionalities</h1><h3>💬 Real-Time Messaging</h3><ul><li><p>Instant chat communication between <strong>users and admin</strong> using <strong>WebSockets (</strong><a target="_blank" rel="noopener noreferrer nofollow" class="text-primary underline" href="http://Socket.IO"><strong>Socket.IO</strong></a><strong>)</strong>.</p></li><li><p>Messages appear instantly without refreshing the page.</p></li></ul><h3>🔐 End-to-End Message Encryption</h3><ul><li><p>Messages are <strong>encrypted using the Fernet encryption algorithm</strong>.</p></li><li><p>Ensures secure communication and protects sensitive information.</p></li></ul><h3>👤 User Chat Session Management</h3><ul><li><p>Users create chat sessions by providing <strong>name, email, phone, and country</strong>.</p></li><li><p>Each session generates a <strong>unique room ID</strong> for communication.</p></li></ul><h3>🧑‍💻 Admin Dashboard</h3><ul><li><p>Admin panel to <strong>monitor all chat sessions</strong>.</p></li><li><p>Allows admins to <strong>reply to messages, manage conversations, and archive sessions</strong>.</p></li></ul><h3>📁 File Sharing Support</h3><ul><li><p>Users can upload and share files such as:</p><ul><li><p>Images</p></li><li><p>Documents (PDF, DOC, TXT, etc.)</p></li></ul></li><li><p>Files are stored securely and served via static routes.</p></li></ul><h3>🔔 Email Notifications</h3><ul><li><p>Admin receives <strong>email notifications when a new chat request is created</strong>.</p></li></ul><h3>🛡️ Security &amp; Validation</h3><ul><li><p>Input sanitization to prevent <strong>XSS attacks</strong>.</p></li><li><p>Rate limiting to prevent <strong>spam or abuse</strong>.</p></li><li><p>File upload validation and size limits.</p></li></ul><h3>📊 Message Status Tracking</h3><p>Tracks message states including:</p><ul><li><p>Sent</p></li><li><p>Seen by user</p></li><li><p>Seen by admin</p></li><li><p>Timestamp tracking</p></li></ul><h3>🚀 Session &amp; Chat Management</h3><ul><li><p>Active session tracking</p></li><li><p>Chat archiving system</p></li><li><p>Secure session handling<br></p></li></ul><hr><h1>🧰 Technology Stack</h1><h3>🖥 Backend</h3><ul><li><p>🐍 <strong>Python</strong></p></li><li><p>⚡ <strong>Flask</strong> – Web framework</p></li><li><p>🔌 <strong>Flask-SocketIO</strong> – Real-time WebSocket communication</p></li><li><p>🗄 <strong>SQLAlchemy</strong> – Database ORM</p></li><li><p>🚦 <strong>Flask-Limiter</strong> – API rate limiting and security</p></li></ul><h3>🗄 Database</h3><ul><li><p><strong>SQLite / SQLAlchemy Database</strong></p></li></ul><h3>🔐 Security &amp; Encryption</h3><ul><li><p><strong>Cryptography (Fernet Encryption)</strong> – Secure message encryption</p></li><li><p><strong>Input Sanitization</strong> – Protection against malicious scripts</p></li></ul><h3>📡 Communication</h3><ul><li><p><strong>WebSockets (</strong><a target="_blank" rel="noopener noreferrer nofollow" class="text-primary underline" href="http://Socket.IO"><strong>Socket.IO</strong></a><strong>)</strong> – Real-time chat updates</p></li></ul><h3>🌐 Frontend</h3><ul><li><p><strong>HTML5</strong></p></li><li><p><strong>CSS3</strong></p></li><li><p><strong>JavaScript</strong></p></li><li><p>Separate <strong>User UI and Admin Dashboard</strong><br></p></li></ul><h3>📂 File Handling</h3><ul><li><p><strong>Werkzeug</strong> – Secure file uploads</p></li><li><p>Static file serving for uploaded files<br></p></li></ul><h3>📧 Notification System</h3><ul><li><p><strong>SMTP Email Integration</strong> for admin notifications<br></p></li></ul><hr><h3>🎯 Use Cases</h3><p>This chat system can be used for:</p><ul><li><p>🌐 Website <strong>Live Customer Support</strong></p></li><li><p>🛍 <strong>E-commerce customer assistance</strong></p></li><li><p>🏢 <strong>Business inquiry chat systems</strong></p></li><li><p>💼 <strong>Client support portals</strong></p></li></ul><hr>