<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Piyush Gupta</title>
    <description>The latest articles on DEV Community by Piyush Gupta (@knight0916).</description>
    <link>https://dev.to/knight0916</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F3995091%2Fd2bcde73-90e2-4c8d-8a2b-a67d97053367.png</url>
      <title>DEV Community: Piyush Gupta</title>
      <link>https://dev.to/knight0916</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/knight0916"/>
    <language>en</language>
    <item>
      <title>EchoDesk — Turn Google Reviews into Revenue &amp; Operational Fixes for Local Businesses</title>
      <dc:creator>Piyush Gupta</dc:creator>
      <pubDate>Sat, 17 Oct 2026 14:23:36 +0000</pubDate>
      <link>https://dev.to/knight0916/echodesk-turn-google-reviews-into-revenue-operational-fixes-for-local-businesses-51nm</link>
      <guid>https://dev.to/knight0916/echodesk-turn-google-reviews-into-revenue-operational-fixes-for-local-businesses-51nm</guid>
      <description>&lt;p&gt;&lt;em&gt;This is a submission for the &lt;a href="https://dev.to/challenges/hacktoberfest-week2-2026-10-12"&gt;Hacktoberfest Open-Source AI Challenge Week 2: Side Hustle&lt;/a&gt;&lt;/em&gt;&lt;/p&gt;




&lt;h2&gt;
  
  
  What I Built
&lt;/h2&gt;

&lt;p&gt;Most small business owners—cafe operators, dentists, salon owners, boutique retail managers—live in dread of their Google Maps notifications.&lt;/p&gt;

&lt;p&gt;A single 2-star review about slow service can ruin their morning. Meanwhile, enterprise reputation management software like Birdeye or Yext costs &lt;strong&gt;$200 to $500 per month&lt;/strong&gt;, locks them into punitive annual contracts, and overwhelms them with corporate jargon. Independent business owners don't need a bloated CRM; they need answers to two simple questions:&lt;/p&gt;

&lt;blockquote&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;em&gt;"What is actually breaking on my floor or in my kitchen during rush hour?"&lt;/em&gt;
&lt;/li&gt;
&lt;li&gt;&lt;em&gt;"How do I draft an empathetic, professional reply to this customer in 10 seconds without sounding like a robotic bot?"&lt;/em&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;/blockquote&gt;

&lt;p&gt;&lt;strong&gt;EchoDesk&lt;/strong&gt; is an open-source, privacy-first review intelligence audit tool and micro-SaaS side hustle built specifically for independent storefronts.&lt;/p&gt;

&lt;h3&gt;
  
  
  ⚡ The Core Loop:
&lt;/h3&gt;

&lt;ol&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;🔗 1-Click Live Google Maps Extraction (Powered by SerpApi):&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
Paste any Google Maps URL or enter a business name (e.g. &lt;em&gt;Blue Tokai Coffee&lt;/em&gt;, &lt;em&gt;Benne Cyberhub&lt;/em&gt;). EchoDesk connects directly to Google's live review graph, fetching customer reviews, star ratings, reviewer metadata, and timestamps without requiring cumbersome Google Business Profile OAuth verification.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;🧠 AI Sentiment &amp;amp; Operational Bottleneck Clustering:&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
Instead of just showing average stars, the open-weight AI engine categorizes reviews into operational themes:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;⏳ &lt;strong&gt;Peak-Hour Waiting Delays&lt;/strong&gt;
&lt;/li&gt;
&lt;li&gt;🤝 &lt;strong&gt;Staff Hospitality &amp;amp; Service&lt;/strong&gt;
&lt;/li&gt;
&lt;li&gt;🍽️ &lt;strong&gt;Menu Consistency &amp;amp; Quality&lt;/strong&gt;
&lt;/li&gt;
&lt;li&gt;✨ &lt;strong&gt;Ambiance &amp;amp; Cleanliness&lt;/strong&gt;
&lt;/li&gt;
&lt;li&gt;💰 &lt;strong&gt;Value &amp;amp; Pricing Perception&lt;/strong&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;✍️ Brand-Voice AI Reply Assistant:&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
Drafts thoughtful, context-aware replies tailored to individual customer experiences in three distinct brand tones:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;em&gt;Warm &amp;amp; Professional&lt;/em&gt;&lt;/li&gt;
&lt;li&gt;&lt;em&gt;Short &amp;amp; Friendly&lt;/em&gt;&lt;/li&gt;
&lt;li&gt;
&lt;em&gt;Apologetic &amp;amp; Service-Focused&lt;/em&gt;
Replies never hallucinate fake discounts or contact info, address customers by name, and are copy-ready in one click.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;📋 Interactive Operational Action Checklist:&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
Translates recurring customer complaints into concrete business fixes (e.g., &lt;em&gt;"Prep secondary line between 7–9 PM to reduce pickup delays"&lt;/em&gt;). Operators can click &lt;strong&gt;"Add Action"&lt;/strong&gt;, manage a live interactive checklist, and export it as a CSV for floor managers.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;💰 "Fake Door" Demand Validation &amp;amp; Waitlist Engine:&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
To prove commercial demand before building complex billing infrastructure, EchoDesk features a high-converting &lt;strong&gt;Pro Waitlist Modal&lt;/strong&gt; ("50% off lifetime access") connected to a real-time &lt;strong&gt;Owner Analytics Demand Tracker&lt;/strong&gt; that logs interested business owners and exports the waitlist to CSV.&lt;/p&gt;&lt;/li&gt;
&lt;/ol&gt;




&lt;h2&gt;
  
  
  Demo
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;🌐 &lt;strong&gt;Live Web App (Hosted on Render):&lt;/strong&gt; &lt;a href="https://echodesk-6qd3.onrender.com" rel="noopener noreferrer"&gt;https://echodesk-6qd3.onrender.com&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;⚡ &lt;strong&gt;API Health Endpoint:&lt;/strong&gt; &lt;a href="https://echodesk-6qd3.onrender.com/api/health" rel="noopener noreferrer"&gt;https://echodesk-6qd3.onrender.com/api/health&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;🧪 &lt;strong&gt;Instant Test Mode:&lt;/strong&gt; If you don't have a live Google Maps link on hand, click &lt;strong&gt;"Take a Benchmark Business for a spin"&lt;/strong&gt; on the dashboard to immediately analyze 48 realistic customer reviews across dining, wait times, and hospitality.&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  Code
&lt;/h2&gt;

&lt;p&gt;EchoDesk is 100% open-source under the MIT license:&lt;/p&gt;


&lt;div class="ltag-github-readme-tag"&gt;
  &lt;div class="readme-overview"&gt;
    &lt;h2&gt;
      &lt;img src="https://assets.dev.to/assets/github-logo-5a155e1f9a670af7944dd5e12375bc76ed542ea80224905ecaf878b9157cdefc.svg" alt="GitHub logo"&gt;
      &lt;a href="https://github.com/guptapiyush16" rel="noopener noreferrer"&gt;
        guptapiyush16
      &lt;/a&gt; / &lt;a href="https://github.com/guptapiyush16/EchoDesk" rel="noopener noreferrer"&gt;
        EchoDesk
      &lt;/a&gt;
    &lt;/h2&gt;
    &lt;h3&gt;
      
    &lt;/h3&gt;
  &lt;/div&gt;
  &lt;div class="ltag-github-body"&gt;
    
&lt;div id="readme" class="md"&gt;&lt;div class="markdown-heading"&gt;
&lt;h1 class="heading-element"&gt;EchoDesk — Online Review Intelligence &amp;amp; Operational Fixes ⚡&lt;/h1&gt;
&lt;/div&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Turn customer reviews into revenue, brand loyalty, and operational decisions.&lt;/strong&gt;&lt;br&gt;
&lt;em&gt;A fast, privacy-first, one-time online audit tool and micro-SaaS for local businesses.&lt;/em&gt;&lt;br&gt;
Built for &lt;strong&gt;Hacktoberfest Open-Source AI Challenge Week 2: Side Hustle&lt;/strong&gt;.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;&lt;a href="https://reactjs.org/" rel="nofollow noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/f36ae3009ff890d9457f56eede37c6d00e6f169097fc9c1298c911f7a6379f6c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f52656163742d31382d3631444146422e7376673f7374796c653d666c6174266c6f676f3d7265616374" alt="React"&gt;&lt;/a&gt;
&lt;a href="https://www.typescriptlang.org/" rel="nofollow noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/ae3bd8f5e4fa69e2aaddfe09fb526b558e156d48d8fed7c5933e2d42df9cf8a0/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f547970655363726970742d352e362d3331373843362e7376673f7374796c653d666c6174266c6f676f3d74797065736372697074" alt="TypeScript"&gt;&lt;/a&gt;
&lt;a href="https://vitejs.dev/" rel="nofollow noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/745b666be100299ec2b1baa24b56ac6830270626441be0a265a43485122e3ef3/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f566974652d362e342d3634364346462e7376673f7374796c653d666c6174266c6f676f3d76697465" alt="Vite"&gt;&lt;/a&gt;
&lt;a href="https://render.com/" rel="nofollow noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/eecd9974789ec5c1c8ef74ba7aee7889ac82c7a47913f2d85fbe52b4070208c1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f52656e6465722d486f737465642532304c6976652d3436453342372e7376673f7374796c653d666c6174266c6f676f3d72656e646572" alt="Render"&gt;&lt;/a&gt;
&lt;a href="https://ai.google.dev/" rel="nofollow noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/5edd9e5fe07b073bd597deb9b3c399f3952f82e40bd7aa4ba271c4abb0411e77/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f476f6f676c6525323041492d47656d6d6125323025323625323047656d696e692d3845373542322e7376673f7374796c653d666c6174266c6f676f3d676f6f676c65" alt="Google AI"&gt;&lt;/a&gt;
&lt;a href="https://serpapi.com/" rel="nofollow noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/8b3cbff7ca97d5a7eeb6dd8f33de53f4b0048df6961784cbaae6050157a0f5d3/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c69766525323045787472616374696f6e2d536572704150492d3030414136432e7376673f7374796c653d666c6174" alt="SerpAPI"&gt;&lt;/a&gt;
&lt;a href="https://github.com/guptapiyush16/EchoDesk/LICENSE" rel="noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/fdf2982b9f5d7489dcf44570e714e3a15fce6253e0cc6b5aa61a075aac2ff71b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d79656c6c6f772e737667" alt="License: MIT"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;div class="markdown-heading"&gt;
&lt;h2 class="heading-element"&gt;🌟 The Problem &amp;amp; The Solution&lt;/h2&gt;
&lt;/div&gt;
&lt;p&gt;Independent storefront owners—cafe operators, dentists, salon owners, boutique retail managers—live in dread of their Google Maps notifications. A single 2-star review about slow service can ruin their morning.&lt;/p&gt;
&lt;p&gt;Meanwhile, enterprise reputation management software like Birdeye or Yext charges &lt;strong&gt;$200 to $500 per month&lt;/strong&gt;, locks owners into annual contracts, and buries them in corporate jargon. Small business owners don't need a bloated CRM; they need answers to two simple questions:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;"What is actually breaking on my floor or in my kitchen during rush hour?"&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;"How do I draft an empathetic, professional reply to this customer in 10 seconds without sounding like a&lt;/strong&gt;…&lt;/li&gt;
&lt;/ol&gt;&lt;/div&gt;
  &lt;/div&gt;
  &lt;div class="gh-btn-container"&gt;&lt;a class="gh-btn" href="https://github.com/guptapiyush16/EchoDesk" rel="noopener noreferrer"&gt;View on GitHub&lt;/a&gt;&lt;/div&gt;
&lt;/div&gt;


&lt;p&gt;🔗 &lt;strong&gt;Repository:&lt;/strong&gt; &lt;a href="https://github.com/guptapiyush16/EchoDesk" rel="noopener noreferrer"&gt;https://github.com/guptapiyush16/EchoDesk&lt;/a&gt;&lt;/p&gt;

&lt;h3&gt;
  
  
  Quickstart (Run Locally in 60 seconds):
&lt;/h3&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="c"&gt;# Clone the repository&lt;/span&gt;
git clone https://github.com/guptapiyush16/EchoDesk.git
&lt;span class="nb"&gt;cd &lt;/span&gt;EchoDesk

&lt;span class="c"&gt;# Install dependencies&lt;/span&gt;
npm &lt;span class="nb"&gt;install&lt;/span&gt;

&lt;span class="c"&gt;# Start backend server &amp;amp; frontend dev server&lt;/span&gt;
npm start
npm run dev
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  How I Built It
&lt;/h2&gt;

&lt;p&gt;EchoDesk combines lightweight open-weight AI architectures, resilient live web data extraction, and serverless-friendly cloud hosting:&lt;/p&gt;

&lt;h3&gt;
  
  
  1. 🔍 Live Review Extraction via SerpApi
&lt;/h3&gt;

&lt;p&gt;Extracting reviews from modern Google Maps single-page apps is notoriously brittle with headless scrapers. EchoDesk integrates &lt;strong&gt;SerpApi's Google Maps Reviews Engine&lt;/strong&gt; via a protected Node.js backend proxy (&lt;code&gt;server/server.mjs&lt;/code&gt;). It sanitizes input queries, fetches real-time customer comments with high fidelity, and formats review snippets, ratings, and dates into normalized JSON.&lt;/p&gt;

&lt;h3&gt;
  
  
  2. 🤖 Open-Weight AI Intelligence (Gemma &amp;amp; Google AI)
&lt;/h3&gt;

&lt;p&gt;The AI pipeline handles two heavy operational workloads:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Zero-Shot Root-Cause Extraction:&lt;/strong&gt; Parses batches of raw reviews into fine-grained sentiment distributions and pinpointed operational problems.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Brand Voice Synthesis:&lt;/strong&gt; Uses structured system prompts to generate human-grade, tone-matched review responses under 120 words without generic platitudes or robotic phrasing.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  3. ☁️ Production Runtime on Render
&lt;/h3&gt;

&lt;p&gt;Render powers the entire production lifecycle:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Configured via Infrastructure-as-Code with &lt;a href="https://github.com/guptapiyush16/EchoDesk/blob/main/render.yaml" rel="noopener noreferrer"&gt;&lt;code&gt;render.yaml&lt;/code&gt;&lt;/a&gt;.&lt;/li&gt;
&lt;li&gt;A unified Node.js / Express service serves the compiled React 18 / Vite client bundle, hosts the secure authenticated REST API proxy, manages session security, and executes health monitoring.&lt;/li&gt;
&lt;li&gt;Zero-downtime continuous deployment connected directly to the GitHub &lt;code&gt;main&lt;/code&gt; branch.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  4. 📊 Demand Validation &amp;amp; Data Persistence
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Zero Lock-in Local Storage:&lt;/strong&gt; Client-side caching preserves business profiles and action items across tab refreshes.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;JSON Waitlist Engine:&lt;/strong&gt; Saves prospective customer leads securely into &lt;code&gt;data/waitlist.json&lt;/code&gt; on the server, complete with deduplication, timestamping, and instant CSV export for marketing outreach.&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  Why Does Open Innovation Matter?
&lt;/h2&gt;

&lt;p&gt;For an indie developer building a sustainable side hustle, open innovation is the difference between an unviable money pit and a profitable micro-SaaS:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Vastly Superior Unit Economics:&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
Closed enterprise reputation platforms charge hundreds of dollars per seat because they carry immense operational overhead. By building on lightweight, cost-effective models and open web standards, EchoDesk's cost per audit is fractions of a cent. This allows us to offer independent neighborhood cafes a free audit and a paid tier starting at just &lt;strong&gt;₹299/month ($3.50/mo)&lt;/strong&gt; while maintaining 90%+ gross margins.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Data Privacy for Local Businesses:&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
Small business owners are rightfully cautious about sharing internal feedback and customer identities with closed, data-harvesting ad networks. EchoDesk's modular architecture processes customer reviews securely through private proxies with zero retention of customer PII on third-party tracking databases.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;No Vendor Lock-in or Arbitrary API Hikes:&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
Relying entirely on a proprietary end-to-end platform leaves a founder vulnerable to overnight pricing changes or sudden terms-of-service bans. Open innovation allows EchoDesk to swap model weights, transition from cloud-hosted inference to local on-premise models, and customize prompts to match hyper-specific local industries.&lt;/p&gt;&lt;/li&gt;
&lt;/ol&gt;




&lt;h2&gt;
  
  
  My Agent Session
&lt;/h2&gt;

&lt;p&gt;EchoDesk was developed, architected, and refactored using &lt;strong&gt;GitHub Copilot's CLI&lt;/strong&gt; and agentic coding workflows:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Scaffolding the React 18 / TypeScript / Vite frontend with custom CSS tokens.&lt;/li&gt;
&lt;li&gt;Structuring the resilient SerpApi proxy to parse Google Maps place queries and pagination.&lt;/li&gt;
&lt;li&gt;Authoring the declarative &lt;code&gt;render.yaml&lt;/code&gt; specification for zero-configuration cloud deployments.&lt;/li&gt;
&lt;li&gt;Implementing the "Fake Door" Pro waitlist modal with server-side validation and CSV export utilities.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;All iterative development steps and architectural refactors are documented transparently in the &lt;a href="https://github.com/guptapiyush16/EchoDesk/commits/main" rel="noopener noreferrer"&gt;GitHub commit history&lt;/a&gt;.&lt;/p&gt;




&lt;h2&gt;
  
  
  My First User
&lt;/h2&gt;

&lt;p&gt;To test if real business owners would actually pay for this, I shared EchoDesk with the owner of a busy local specialty bakery and espresso bar:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;What they did:&lt;/strong&gt; Pasted their Google Maps listing into EchoDesk and ran an instant audit on 35 recent reviews.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The "Aha!" moment:&lt;/strong&gt; The dashboard immediately flagged:
&lt;em&gt;⚠️ Waiting Time &amp;amp; Delays: 32% of 2-star and 3-star reviews mentioned long morning queues during the 8:30 AM–10:00 AM rush.&lt;/em&gt;
The owner remarked:
&amp;gt; &lt;em&gt;"I knew we were slammed in the morning, but I didn't realize customers were specifically complaining about the toast-warming delay at the counter. The AI pointed out the exact line bottleneck in 5 seconds."&lt;/em&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;The Response:&lt;/strong&gt; In less than 3 minutes, they used the AI Reply Assistant to draft and copy personalized replies to 8 pending reviews that had been sitting unanswered for weeks.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Commercial Validation:&lt;/strong&gt; When they hit the 50-review limit and saw the &lt;strong&gt;"Upgrade to Pro — 50% Off Lifetime Access"&lt;/strong&gt; modal, they immediately entered their business email to claim early founder pricing. That real signup proved demand on day one!&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  Prize Categories
&lt;/h2&gt;

&lt;h3&gt;
  
  
  🌟 Featured Categories:
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Best Use of Render ($200 USD):&lt;/strong&gt; Render acts as our end-to-end production runtime. Configured via &lt;code&gt;render.yaml&lt;/code&gt;, it hosts the Node.js API, serves the optimized Vite SPA bundle, manages environment security, and handles continuous deployments.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Best Use of Gemma ($200 USD):&lt;/strong&gt; Powered by Google's open-weight AI models via Google AI Studio for review sentiment scoring, operational theme classification, and tone-matched customer reply synthesis.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  🤝 Partner Categories:
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Best Use of SerpApi ($100 USD):&lt;/strong&gt; SerpApi's Google Maps Reviews API is the core data ingestion engine of EchoDesk, allowing business owners to pull live reviews, star ratings, and location metadata directly from a public URL.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Best Use of GitHub Copilot ($100 USD):&lt;/strong&gt; Developed and iterated using GitHub Copilot's coding agent and terminal tools to architect API bridges, build custom UI tokens, and write the CSV streaming pipeline.&lt;/li&gt;
&lt;/ul&gt;




&lt;p&gt;&lt;em&gt;Turn complaints into operational fixes, protect your brand, and turn customer reviews into your biggest growth engine!&lt;/em&gt; ⚡📈&lt;/p&gt;

</description>
      <category>devchallenge</category>
      <category>hf26challenge</category>
      <category>serpapi</category>
      <category>opensource</category>
    </item>
    <item>
      <title>WildDex - The Real-World Field Guide &amp; IRL Pokédex Powered by Render</title>
      <dc:creator>Piyush Gupta</dc:creator>
      <pubDate>Thu, 08 Oct 2026 07:33:00 +0000</pubDate>
      <link>https://dev.to/knight0916/hacktoberfest-week-1-wilddex-the-real-world-field-guide-irl-pokedex-powered-by-render-2ofe</link>
      <guid>https://dev.to/knight0916/hacktoberfest-week-1-wilddex-the-real-world-field-guide-irl-pokedex-powered-by-render-2ofe</guid>
      <description>&lt;p&gt;&lt;em&gt;This is a submission for the &lt;a href="https://dev.to/challenges/hacktoberfest-week1-2026-10-05"&gt;Hacktoberfest Open-Source AI Challenge Week 1: Touch Grass&lt;/a&gt;&lt;/em&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  What I Built
&lt;/h2&gt;

&lt;p&gt;Most apps are engineered to maximize your screen time. Endless feeds, streaks, and engagement hooks keep you indoors, eyes glued to a display.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;WildDex&lt;/strong&gt; does the exact opposite. It is an installable, mobile-first Progressive Web App (PWA) with a single mission:&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;em&gt;"The AI isn’t trying to keep you on the screen. It gives you a reason to put the phone down and touch grass."&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h3&gt;
  
  
  🌿 The Core Loop:
&lt;/h3&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;🎮 Daily Quests (Quest Master):&lt;/strong&gt; Every morning, the AI &lt;strong&gt;Quest Master&lt;/strong&gt; analyzes your local city, interests (trees, birds, insects, flowers, domestic animals, minerals), and time budget (15, 30, or 60 min) to generate 3 safe outdoor quests:

&lt;ul&gt;
&lt;li&gt;
&lt;code&gt;📸 Scan&lt;/code&gt;: Find and photograph a specific specimen you haven't seen today.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;👣 Walk&lt;/code&gt;: Take a 1.0 km walk with live HTML5 GPS distance tracking.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;👀 Observe&lt;/code&gt;: Notice a subtle detail or seasonal shift in your neighbourhood.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;📸 AI Discovery Scanner:&lt;/strong&gt; When you spot something intriguing outside (a plant, bird, insect, mushroom, rock, or animal), open the camera viewfinder. The multimodal vision model analyzes the photo, providing an honest confidence rating (e.g., &lt;em&gt;Golden Retriever 99%&lt;/em&gt; or &lt;em&gt;Indian Banyan 91%&lt;/em&gt;), native habitat details, and natural history field facts.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;📖 Your Real-World Pokédex:&lt;/strong&gt; Every unique species is deduplicated and permanently cataloged. Photographing familiar species rewards bonus XP for revisiting local nature (&lt;code&gt;Already discovered! 🌳 +5 XP&lt;/code&gt;).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;⭐ Level Up in Real Life:&lt;/strong&gt; Complete quests and document real-world biodiversity to earn XP, level up your explorer rank (from &lt;em&gt;Junior Scout&lt;/em&gt; to &lt;em&gt;Apex Trailblazer&lt;/em&gt;), and build consecutive daily outdoor streaks.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;🗺️ Trail Log &amp;amp; Adventure Map:&lt;/strong&gt; Tracks distance walked, active minutes, and plots your sightings on a live radar breadcrumb trail.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;WildDex is built for everyday walkers, nature lovers, families, and anyone needing a playful RPG reason to step outside and explore.&lt;/p&gt;




&lt;h2&gt;
  
  
  Demo
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;🌐 &lt;strong&gt;Live Web App (Hosted on Render):&lt;/strong&gt; &lt;a href="https://sidequest-0kzp.onrender.com" rel="noopener noreferrer"&gt;https://sidequest-0kzp.onrender.com&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;📱 &lt;strong&gt;Mobile PWA Ready:&lt;/strong&gt; Open the link in iOS Safari or Android Chrome, select &lt;strong&gt;"Add to Home Screen"&lt;/strong&gt;, and WildDex launches as an installable standalone app with offline service worker caching.&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  Code
&lt;/h2&gt;

&lt;p&gt;WildDex is 100% open-source under the MIT license:&lt;/p&gt;


&lt;div class="ltag-github-readme-tag"&gt;
  &lt;div class="readme-overview"&gt;
    &lt;h2&gt;
      &lt;img src="https://assets.dev.to/assets/github-logo-5a155e1f9a670af7944dd5e12375bc76ed542ea80224905ecaf878b9157cdefc.svg" alt="GitHub logo"&gt;
      &lt;a href="https://github.com/guptapiyush16" rel="noopener noreferrer"&gt;
        guptapiyush16
      &lt;/a&gt; / &lt;a href="https://github.com/guptapiyush16/SideQuest" rel="noopener noreferrer"&gt;
        SideQuest
      &lt;/a&gt;
    &lt;/h2&gt;
    &lt;h3&gt;
      
    &lt;/h3&gt;
  &lt;/div&gt;
  &lt;div class="ltag-github-body"&gt;
    
&lt;div id="readme" class="md"&gt;&lt;div class="markdown-heading"&gt;
&lt;h1 class="heading-element"&gt;WildDex — Production PWA&lt;/h1&gt;
&lt;/div&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Core Loop:&lt;/strong&gt; Go outside → get a quest → do something → discover something → collect it → earn XP.&lt;br&gt;
&lt;em&gt;"The AI isn’t trying to keep you on the screen. It gives you a reason to put the phone down."&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;The repository contains one canonical app: the browser PWA in &lt;code&gt;index.html&lt;/code&gt;, &lt;code&gt;styles.css&lt;/code&gt;, &lt;code&gt;js/&lt;/code&gt;, &lt;code&gt;assets/&lt;/code&gt;, and the Node/Express API in &lt;code&gt;server.js&lt;/code&gt;.&lt;/p&gt;
&lt;div class="markdown-heading"&gt;
&lt;h2 class="heading-element"&gt;📱 How to Run &amp;amp; Install as a Mobile PWA&lt;/h2&gt;
&lt;/div&gt;
&lt;div class="markdown-heading"&gt;
&lt;h3 class="heading-element"&gt;1. Run Locally&lt;/h3&gt;
&lt;/div&gt;
&lt;p&gt;The app is currently running on &lt;strong&gt;&lt;code&gt;http://localhost:3000&lt;/code&gt;&lt;/strong&gt;.&lt;br&gt;
To restart the server at any time:&lt;/p&gt;
&lt;div class="highlight highlight-source-shell notranslate position-relative overflow-auto js-code-highlight"&gt;
&lt;pre&gt;npm install
npm start&lt;/pre&gt;

&lt;/div&gt;
&lt;p&gt;The server loads local development values from &lt;code&gt;atlas-credentials.env&lt;/code&gt;. Keep that file private. For Render, configure the same variables in the service environment.&lt;/p&gt;
&lt;p&gt;The PWA and API run from the same origin. Atlas stores accounts, progress, and GridFS photo files behind authenticated API routes.&lt;/p&gt;
&lt;div class="markdown-heading"&gt;
&lt;h3 class="heading-element"&gt;Managed AI deployment&lt;/h3&gt;

&lt;/div&gt;
&lt;p&gt;Configure &lt;code&gt;OPEN_ROUTER_APIKEY&lt;/code&gt;…&lt;/p&gt;&lt;/div&gt;
  &lt;/div&gt;
  &lt;div class="gh-btn-container"&gt;&lt;a class="gh-btn" href="https://github.com/guptapiyush16/SideQuest" rel="noopener noreferrer"&gt;View on GitHub&lt;/a&gt;&lt;/div&gt;
&lt;/div&gt;


&lt;p&gt;🔗 &lt;strong&gt;Repository:&lt;/strong&gt; &lt;a href="https://github.com/guptapiyush16/SideQuest" rel="noopener noreferrer"&gt;https://github.com/guptapiyush16/SideQuest&lt;/a&gt;&lt;/p&gt;




&lt;h2&gt;
  
  
  How I Built It
&lt;/h2&gt;

&lt;p&gt;WildDex combines a modern local-first PWA, a resilient dual-provider AI pipeline, and production cloud infrastructure:&lt;/p&gt;

&lt;h3&gt;
  
  
  1. 🤖 Resilient Multimodal AI Architecture
&lt;/h3&gt;

&lt;p&gt;WildDex powers its core experience through two dedicated server-side AI engines:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;🎮 Quest Master Engine:&lt;/strong&gt; Dynamically constructs structured, context-aware quests strictly bounded by safety guidelines (public parks, no trespassing, realistic walking targets).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;📸 Field Guide Vision Scanner:&lt;/strong&gt; Multimodal AI model that classifies camera photos with honest uncertainty estimation. It outputs ranked candidate distributions, confidence scores, and natural history facts.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Dual-Provider Resilience:&lt;/strong&gt; Implemented a zero-downtime failover pipeline in Node.js (&lt;code&gt;api/ai.js&lt;/code&gt;). If primary requests encounter high-demand spikes or rate limits, the runtime automatically fails over within seconds so mobile users are never left hanging on a trail.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  2. ⚡ Production Runtime on Render
&lt;/h3&gt;

&lt;p&gt;Render powers the entire production lifecycle:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;A unified Node.js / Express web service declared via infrastructure-as-code in &lt;code&gt;render.yaml&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;Serves the installable PWA frontend, runs the authenticated REST API, and hosts the server-side AI proxy so API secrets are never exposed in browser bundles.&lt;/li&gt;
&lt;li&gt;Automatic continuous deployment connected directly to GitHub &lt;code&gt;main&lt;/code&gt; with health check monitoring at &lt;code&gt;/api/health&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  3. 🍃 Data &amp;amp; Media Layer on MongoDB Atlas
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;User Accounts &amp;amp; Progression:&lt;/strong&gt; Managed with secure JWT authentication and bcrypt password hashing.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Pokédex &amp;amp; Quest Sync:&lt;/strong&gt; Stores unique species entries, duplicate sighting counts, and GPS coordinates.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;MongoDB GridFS Bucket (&lt;code&gt;photos&lt;/code&gt;):&lt;/strong&gt; Captured field photos are compressed client-side (HTML5 Canvas down to 1200px at ~200KB) and streamed into MongoDB GridFS binary storage, linked directly to the user's discovery record.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  4. 💻 Engineered with GitHub Copilot
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;Leveraged the &lt;strong&gt;GitHub Copilot coding agent&lt;/strong&gt; and CLI in the terminal to scaffold PWA manifest configurations, architect the GridFS upload pipeline, and optimize client-side image compression routines.&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  Why Does Open Innovation Matter?
&lt;/h2&gt;

&lt;p&gt;When technology is open and accessible, it empowers people to engage with the physical world instead of remaining trapped in walled gardens:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Open Web Standards Over App Store Walled Gardens:&lt;/strong&gt; Built as an open Progressive Web App (PWA) using HTML5, Vanilla CSS, and Service Workers. Anyone on iOS or Android can install it immediately without app store gatekeepers, fees, or downloads.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Accessible Outdoor Education:&lt;/strong&gt; Nature education should be available to everyone—students, park visitors, and community naturalists. Open innovation makes it possible to build lightweight, low-latency tools that work smoothly on budget devices and spotty mobile networks.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Transparent Science &amp;amp; Honest AI:&lt;/strong&gt; Rather than pretending to be 100% omniscient, our open prompts demand transparent confidence distributions and field notes, encouraging explorers to verify observations and stay curious.&lt;/li&gt;
&lt;/ol&gt;




&lt;h2&gt;
  
  
  My Agent Session
&lt;/h2&gt;

&lt;p&gt;This application was developed and iterated using &lt;strong&gt;GitHub Copilot's coding agent&lt;/strong&gt; and terminal workflow. Copilot was used to:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Write and validate the &lt;code&gt;render.yaml&lt;/code&gt; infrastructure-as-code specification.&lt;/li&gt;
&lt;li&gt;Construct the client-side canvas compression pipeline to ensure fast, reliable mobile photo uploads.&lt;/li&gt;
&lt;li&gt;Refactor the server-side AI failover proxy and MongoDB GridFS image streaming handlers.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;em&gt;(Session commits and architectural iterations are documented in the &lt;a href="https://github.com/guptapiyush16/SideQuest/commits/main" rel="noopener noreferrer"&gt;commit history of the GitHub repository&lt;/a&gt;).&lt;/em&gt;&lt;/p&gt;




&lt;h2&gt;
  
  
  Prize Categories
&lt;/h2&gt;

&lt;h3&gt;
  
  
  🌟 Featured Categories:
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Best Use of Render ($200 USD):&lt;/strong&gt; Render serves as our complete production runtime. Declared via &lt;code&gt;render.yaml&lt;/code&gt;, it hosts the Node.js/Express service, serves the mobile PWA frontend, runs the secure AI runtime proxy, and automates zero-downtime GitHub deployments.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  🤝 Partner Categories:
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Best Use of MongoDB Atlas ($100 USD):&lt;/strong&gt; MongoDB Atlas powers the persistent database layer—handling user authentication, Pokédex collections, XP progression, and storing captured discovery photos via a dedicated &lt;strong&gt;MongoDB GridFS Bucket&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Best Use of GitHub Copilot ($100 USD):&lt;/strong&gt; Developed using the GitHub Copilot CLI and coding agent, accelerating infrastructure setup, PWA offline caching, and full-stack API integration.&lt;/li&gt;
&lt;/ul&gt;




&lt;p&gt;&lt;em&gt;Go outside, take a walk, look closer at the world around you, and start filling your WildDex! 🌿🎒&lt;/em&gt;&lt;/p&gt;

</description>
      <category>devchallenge</category>
      <category>hf26challenge</category>
      <category>mongodb</category>
      <category>backend</category>
    </item>
    <item>
      <title>Deadline Buddy — The Open-Source Scholarship Compass That Explains Every Match (Built for a Friend)</title>
      <dc:creator>Piyush Gupta</dc:creator>
      <pubDate>Sun, 04 Oct 2026 16:54:19 +0000</pubDate>
      <link>https://dev.to/knight0916/deadline-buddy-the-open-source-scholarship-compass-that-explains-every-match-built-for-a-friend-1dh7</link>
      <guid>https://dev.to/knight0916/deadline-buddy-the-open-source-scholarship-compass-that-explains-every-match-built-for-a-friend-1dh7</guid>
      <description>&lt;p&gt;&lt;em&gt;This is a submission for the &lt;a href="https://dev.to/challenges/hacktoberfest-weekend-2026-10-01"&gt;Hacktoberfest Weekend Challenge: Build for a Friend&lt;/a&gt;&lt;/em&gt;&lt;/p&gt;




&lt;h2&gt;
  
  
  What I Built
&lt;/h2&gt;

&lt;h3&gt;
  
  
  The Story: Building for a Friend Under a Mountain of PDFs
&lt;/h3&gt;

&lt;p&gt;My close friend is a 3rd-year Computer Science undergraduate at NIT Karnataka, Surathkal in India. Like thousands of ambitious students around the world, their dream is to pursue a Master's degree abroad in AI and Distributed Systems.&lt;/p&gt;

&lt;p&gt;A few weeks ago, I watched them spend an entire weekend buried under a mountain of open browser tabs: &lt;strong&gt;DAAD&lt;/strong&gt; in Germany, &lt;strong&gt;EduCanada&lt;/strong&gt;, &lt;strong&gt;Fulbright&lt;/strong&gt; in the US, and &lt;strong&gt;Chevening&lt;/strong&gt; and &lt;strong&gt;Commonwealth&lt;/strong&gt; in the UK. Each scholarship program had 40- to 80-page PDF guidelines filled with dense institutional jargon:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;&lt;em&gt;"Does a 4-year Indian B.Tech degree count as final-year standing right now?"&lt;/em&gt;&lt;/li&gt;
&lt;li&gt;&lt;em&gt;"Does an 8.4 / 10 CGPA meet the 'first-class honours or 2:1 equivalent' threshold?"&lt;/em&gt;&lt;/li&gt;
&lt;li&gt;&lt;em&gt;"Does a national hackathon finalist certificate satisfy 'demonstrated community leadership'?"&lt;/em&gt;&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Existing scholarship portals were useless: they either acted as clickbait lead-generation farms or slapped an opaque &lt;em&gt;"87% Match"&lt;/em&gt; badge on a card without explaining &lt;strong&gt;why&lt;/strong&gt; they qualified. The alternative—spending 20 hours drafting an essay only to be rejected over a technical disqualifier buried on page 52—was heartbreaking.&lt;/p&gt;

&lt;p&gt;I built &lt;strong&gt;Deadline Buddy&lt;/strong&gt; for my friend.&lt;/p&gt;

&lt;h2&gt;
  
  
  &lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F7ao466ovu8bz7zvf6wlc.png" alt=" " width="800" height="367"&gt;
&lt;/h2&gt;

&lt;h3&gt;
  
  
  What Deadline Buddy Does
&lt;/h3&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F4xhk9f669nfjvgn0mn34.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F4xhk9f669nfjvgn0mn34.png" alt=" " width="800" height="356"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Deadline Buddy turns scholarship discovery into a transparent, stress-free 5-step loop:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;📄 Zero-Friction Document Intake:&lt;/strong&gt; Drop in unofficial transcripts, resumes, or certificates (PDF, DOCX, TXT) or click the 1-click sample button.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;👤 Structured Profile Extraction:&lt;/strong&gt; The system extracts key attributes (GPA, current year of study, degree, graduation year, skills, achievements) into an editable profile with supporting document quotes.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;🌍 Destination Personalization:&lt;/strong&gt; Pick a target country (USA, Canada, UK, Germany, Australia, Netherlands, Singapore, Japan), immediately contextualizing currencies, deadlines, and official guides.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;⚖️ Deterministic Eligibility Matching:&lt;/strong&gt; Instead of letting an LLM guess eligibility, pure deterministic code evaluates published requirements against the profile, categorizing each award into &lt;strong&gt;Eligible (✓)&lt;/strong&gt;, &lt;strong&gt;Needs Verification (🟡)&lt;/strong&gt;, or &lt;strong&gt;Not Eligible (✕)&lt;/strong&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;🔍 The Signature "Why?" Evidence Drawer &amp;amp; AI Strategy Advisor:&lt;/strong&gt;

&lt;ul&gt;
&lt;li&gt;Clicking any status badge reveals a side-by-side audit trail: the exact published clause, the student's extracted evidence, the source document quote, and a link to the official university portal.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;⚡ Ask Open AI Strategy Advisor&lt;/code&gt;&lt;/strong&gt;: Generates a personalized gap plan with feasibility scoring and alternative scholarships.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;&lt;code&gt;🧪 Open AI Guideline Lab&lt;/code&gt;&lt;/strong&gt;: Paste raw institutional PDF announcements to test real-time guideline extraction.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;⏳ Deadline-First Shortlist:&lt;/strong&gt; Saved opportunities are prioritized by nearest deadline so students never miss an application window.&lt;/li&gt;
&lt;/ol&gt;




&lt;h2&gt;
  
  
  Demo
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;🌐 &lt;strong&gt;Live Deployed Application:&lt;/strong&gt; &lt;a href="https://deadline-buddy-nine.vercel.app/" rel="noopener noreferrer"&gt;https://deadline-buddy-nine.vercel.app/&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;⚡ &lt;strong&gt;1-Click Judge Walkthrough:&lt;/strong&gt; On the landing screen, click &lt;strong&gt;&lt;code&gt;⚡ Load Sample Student Documents (1-Click Demo)&lt;/code&gt;&lt;/strong&gt; to instantly populate a real-world academic profile and test the deterministic rules engine across 26 real scholarships!&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  Code
&lt;/h2&gt;


&lt;div class="ltag-github-readme-tag"&gt;
  &lt;div class="readme-overview"&gt;
    &lt;h2&gt;
      &lt;img src="https://assets.dev.to/assets/github-logo-5a155e1f9a670af7944dd5e12375bc76ed542ea80224905ecaf878b9157cdefc.svg" alt="GitHub logo"&gt;
      &lt;a href="https://github.com/guptapiyush16" rel="noopener noreferrer"&gt;
        guptapiyush16
      &lt;/a&gt; / &lt;a href="https://github.com/guptapiyush16/Deadline-Buddy" rel="noopener noreferrer"&gt;
        Deadline-Buddy
      &lt;/a&gt;
    &lt;/h2&gt;
    &lt;h3&gt;
      
    &lt;/h3&gt;
  &lt;/div&gt;
  &lt;div class="ltag-github-body"&gt;
    
&lt;div id="readme" class="md"&gt;&lt;div class="markdown-heading"&gt;
&lt;h1 class="heading-element"&gt;🎓 Deadline Buddy — The Open-Source Scholarship Compass&lt;/h1&gt;
&lt;/div&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;"Find scholarships you're actually eligible for — without reading hundreds of PDF guidelines."&lt;/strong&gt;&lt;br&gt;
&lt;em&gt;Built for the &lt;a href="https://dev.to/challenges/hacktoberfest-weekend-2026-10-01" rel="nofollow"&gt;Hacktoberfest 2026 Weekend Challenge: Build for a Friend&lt;/a&gt;.&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;&lt;a href="https://www.typescriptlang.org/" rel="nofollow noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/8946ab9e23d56aabb16c0e57e56030b30a3e847dabd2557a476cc91b99bf48b6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f547970655363726970742d352e362d626c75652e737667" alt="TypeScript"&gt;&lt;/a&gt;
&lt;a href="https://react.dev/" rel="nofollow noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/00e3e223744f75b14c36b6cd6620a6cbbbb6fb98410cd390a0fadf0a38f3efef/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f52656163742d31392d3631646166622e737667" alt="React"&gt;&lt;/a&gt;
&lt;a href="https://vitejs.dev/" rel="nofollow noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/42c029effeb438b26ae2aa5fcf923cc565fdb9ab38b0fd9cdd14db11ddbd69fd/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f566974652d372e312d3634366366662e737667" alt="Vite"&gt;&lt;/a&gt;
&lt;a href="https://vitest.dev/" rel="nofollow noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/3ce9414a8368319d4bdff224f69c8bba3858968bece69d2500a6dd04862c2b5b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f54657374732d50617373696e672532302831312532463131292d627269676874677265656e2e737667" alt="Tests"&gt;&lt;/a&gt;
&lt;a href="https://github.com/guptapiyush16/Deadline-Buddy#zero-api-keys-guarantee" rel="noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/4394f696336228f34f83bb2f2ba2195092207460b3f25d831a66f536ecc3c743/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4150492532304b6579732d5a65726f25323052657175697265642d737563636573732e737667" alt="Zero API Keys"&gt;&lt;/a&gt;
&lt;a href="https://github.com/guptapiyush16/Deadline-Buddy/LICENSE" rel="noopener noreferrer"&gt;&lt;img src="https://camo.githubusercontent.com/fdf2982b9f5d7489dcf44570e714e3a15fce6253e0cc6b5aa61a075aac2ff71b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d79656c6c6f772e737667" alt="License: MIT"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;div class="markdown-heading"&gt;
&lt;h2 class="heading-element"&gt;📖 The Story: Building for a Friend&lt;/h2&gt;
&lt;/div&gt;
&lt;p&gt;My close friend is a 3rd-year Computer Science undergraduate at NIT Karnataka, Surathkal in India. Like thousands of ambitious students worldwide, their dream is to pursue a Master's degree abroad in AI and Distributed Systems.&lt;/p&gt;
&lt;p&gt;A few weeks ago, I watched them spend an entire weekend buried under dozens of open browser tabs: &lt;strong&gt;DAAD&lt;/strong&gt; in Germany, &lt;strong&gt;EduCanada&lt;/strong&gt;, &lt;strong&gt;Fulbright&lt;/strong&gt; in the US, &lt;strong&gt;Chevening&lt;/strong&gt; and &lt;strong&gt;Commonwealth&lt;/strong&gt; in the UK. Each scholarship program had 40- to 80-page PDF guidelines filled with dense institutional jargon:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;em&gt;"Does a 4-year Indian B.Tech degree count as final-year standing right now?"&lt;/em&gt;&lt;/li&gt;
&lt;li&gt;&lt;em&gt;"Does an 8.4 / 10 CGPA satisfy the 'first-class honours or 2:1 equivalent' threshold?"&lt;/em&gt;&lt;/li&gt;
&lt;li&gt;
&lt;em&gt;"Does a&lt;/em&gt;…&lt;/li&gt;
&lt;/ul&gt;&lt;/div&gt;
  &lt;/div&gt;
  &lt;div class="gh-btn-container"&gt;&lt;a class="gh-btn" href="https://github.com/guptapiyush16/Deadline-Buddy" rel="noopener noreferrer"&gt;View on GitHub&lt;/a&gt;&lt;/div&gt;
&lt;/div&gt;


&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;GitHub Repository:&lt;/strong&gt; &lt;a href="https://github.com/guptapiyush16/Deadline-Buddy" rel="noopener noreferrer"&gt;https://github.com/guptapiyush16/Deadline-Buddy&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Tech Stack:&lt;/strong&gt; React 19, TypeScript, Vite, Tailwind CSS, Vitest (11/11 passing tests), Client-side PDF/DOCX Parsing (&lt;code&gt;pdfjs-dist&lt;/code&gt; + &lt;code&gt;mammoth&lt;/code&gt;).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Zero API Keys Required:&lt;/strong&gt; Runs 100% in-browser on client hardware with 0 external API dependencies.&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  How I Built It
&lt;/h2&gt;

&lt;h3&gt;
  
  
  The Architecture: Open AI for Extraction, Code for Truth
&lt;/h3&gt;

&lt;p&gt;The single biggest engineering mistake in AI applications is letting a non-deterministic LLM make hidden decisions. If you ask an LLM: &lt;em&gt;"Does this student qualify for this scholarship?"&lt;/em&gt;, it will frequently hallucinate or give inconsistent answers.&lt;/p&gt;

&lt;p&gt;Deadline Buddy is built on a &lt;strong&gt;defensible, split-brain architecture&lt;/strong&gt;:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Open-Source AI / Open Weights:&lt;/strong&gt; Used where language models excel — extracting structured JSON from messy PDFs/transcripts and explaining complex mismatches in plain English.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Deterministic TypeScript Code:&lt;/strong&gt; Used where mathematics and logic belong — comparing GPA scales, academic years, and citizenship lists.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;[ Uploaded Documents (Resume / Transcripts / Certificates) ]&lt;br&gt;
                               │&lt;br&gt;
                               ▼&lt;br&gt;
    ┌─────────────────────────────────────────────────────┐&lt;br&gt;
    │ Open-Weight Extractor / Local AST Document Pipeline │&lt;br&gt;
    └──────────────────────────┬──────────────────────────┘&lt;br&gt;
                               │ (Structured JSON Profile + Quotes)&lt;br&gt;
                               ▼&lt;br&gt;
    ┌─────────────────────────────────────────────────────┐&lt;br&gt;
    │           Deterministic Code Rules Engine           │&lt;br&gt;
    │               (shared/eligibility.ts)               │&lt;br&gt;
    │                                                     │&lt;br&gt;
    │  Requirement           Student Profile      Result  │&lt;br&gt;
    │  ─────────────────────────────────────────────────  │&lt;br&gt;
    │  Citizenship: India    India                  ✓     │&lt;br&gt;
    │  Min GPA ≥ 7.5         8.4 / 10               ✓     │&lt;br&gt;
    │  Final Year Standing   3rd year of 4          ✕     │&lt;br&gt;
    └──────────────────────────┬──────────────────────────┘&lt;br&gt;
                               │&lt;br&gt;
                               ▼&lt;br&gt;
    ┌─────────────────────────────────────────────────────┐&lt;br&gt;
    │        Three-State Explainable Evaluation           │&lt;br&gt;
    │  🟢 Eligible    🟡 Needs Verification    🔴 Ineligible&lt;br&gt;
    └──────────────────────────┬──────────────────────────┘&lt;br&gt;
                               │&lt;br&gt;
                               ▼&lt;br&gt;
    ┌─────────────────────────────────────────────────────┐&lt;br&gt;
    │      Interactive "Why?" Evidence Drawer &amp;amp; Shortlist  │&lt;br&gt;
    │      • Exact supporting quotes from your documents  │&lt;br&gt;
    │      • Open AI Strategy Advisor with gap workarounds│&lt;br&gt;
    └─────────────────────────────────────────────────────┘&lt;/p&gt;

&lt;h3&gt;
  
  
  The Three Eligibility States
&lt;/h3&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;🟢 Eligible:&lt;/strong&gt; Every checkable published requirement strictly passes.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;🔴 Ineligible:&lt;/strong&gt; A hard rule failed (e.g. scholarship requires a completed Bachelor's degree, but the student is currently in year 3).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;🟡 Needs Verification (The Crucial Third State):&lt;/strong&gt; The scholarship requires subjective criteria (like "community leadership") or university nomination that cannot be conclusively proven from the transcript. &lt;strong&gt;We refuse to guess or hallucinate an approval when proof is missing.&lt;/strong&gt;
&lt;/li&gt;
&lt;/ol&gt;

&lt;h3&gt;
  
  
  The GPA Uncertainty Band
&lt;/h3&gt;

&lt;p&gt;International GPA scale conversions vary across universities. Deadline Buddy enforces an explicit uncertainty threshold:&lt;/p&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;
typescript
const diff = studentGpaRatio - requiredGpaRatio;
if (diff &amp;gt;= GPA_UNCERTAINTY_BAND) return check(req, "pass", ...);
if (diff &amp;lt;= -GPA_UNCERTAINTY_BAND) return check(req, "fail", ...);
return check(req, "unknown", ...); // Refuse to guess borderline scores!

&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;

</description>
      <category>devchallenge</category>
      <category>weekendchallenge</category>
      <category>hf26challenge</category>
      <category>opensource</category>
    </item>
  </channel>
</rss>
