Skip to content

tomassantos484/StockFinder

Repository files navigation

StockFinder: Real-Time Product Availability Tracker

📌 Overview

StockFinder is a modern web application designed to solve the frustration of searching for in-stock products across multiple retail stores. Whether you're looking for an urgent laptop charger, baby formula, or a high-demand gaming console, StockFinder provides real-time inventory updates, helping users find what they need instantly.

🚀 Find. Reserve. Pick Up. Stop wasting time guessing stock availability!

🛠️ Developed at the DeveloperWeek 2025 Hackathon!

📢 Check it out on DevPost!


🎥 Demo Video

📌 [https://www.youtube.com/watch?v=fF6dKe6vc1A]


image

🔍 What It Does

StockFinder allows users to:

Search for products across retail stores using a product name + ZIP code
Get real-time inventory status from nearby stores
View exact in-store locations, including aisle numbers & store sections

💡 Key Use Cases:

  • A student urgently needs a laptop charger before an assignment deadline.
  • A parent searching for baby formula during a shortage.
  • A gamer trying to secure a PS5 before stock runs out.

🛠️ How We Built It

Frontend:

  • Next.js – Fast, responsive UI
  • 🎨 Tailwind CSS – Clean, modern styling
  • 🔐 Clerk – Secure authentication & user management
  • 🔄 React Hooks – Efficient state management
  • 📌 TypeScript – Type safety for better development

Backend:

  • 🚀 Fastify – High-performance API handling
  • 🔍 Puppeteer & Playwright – Web scraping for real-time inventory
  • 📊 TypeBox – Runtime type checking & API validation
  • Bun – Improved dev performance & package management

Design & Planning:

  • 🖌️ Figma – Wireframing & UI/UX design
  • 🎭 Canva – Logo design & branding
  • 🏗️ Monorepo Architecture – Better project organization

🏆 Accomplishments We're Proud Of

✅ Built a clean & intuitive UI for effortless searching
✅ Developed a robust web scraping solution for Target’s inventory
✅ Implemented a responsive design that works across all devices
✅ Created a scalable architecture that can accommodate more retailers
✅ Maintained high performance while handling real-time data


🚀 What's Next for StockFinder

🔹 AI-Powered Search & Recommendations – Smarter product suggestions
🔹 Expanding Coverage – Adding more major retailers
🔹 Price Comparison – Helping users find the best deals
🔹 Push Notifications – Real-time stock alerts for users


⚡ Built With


🚀 Try it Out!

🖥️ Live Demo: StockFinder Website


Getting Started

  1. Clone the repository
git clone https://github.com/YourOrg/devweek.git
cd devweek


This repository contains our **Fastify server**, **Next.js client**, and **shared** utilities in one npm-based monorepo.

## Getting Started

1. **Clone the repository**
```bash
git clone https://github.com/YourOrg/devweek.git
cd devweek
  1. Install dependencies (installs all workspaces in one go) FROM ROOT:
npm install
  1. Run in development mode (starts the server and client):
npm run dev

About

StockFinder - Developer Week 2025 Hackathon

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •