BeautyMatch

๐Ÿ’„ BeautyMatch โ€“ Smart Skin Compatibility for Beauty Products

BeautyMatch is a privacy-first Chrome Extension that analyzes beauty product pages from Amazon.in, Sephora India, and Nykaa, and shows whether a product is a Good Match, Caution, or Not Recommended based on your skin profile.


๐Ÿš€ Features


๐Ÿ“ Project Structure

BeautyMatch/
โ”œโ”€โ”€ public/
โ”‚   โ”œโ”€โ”€ manifest.json              # Chrome extension config (MV3)
โ”‚   โ”œโ”€โ”€ onboarding.html            # Onboarding page HTML
โ”‚   โ””โ”€โ”€ icons/                     # Extension icons
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ pages/
โ”‚   โ”‚   โ””โ”€โ”€ Onboarding.tsx         # Onboarding React component
โ”‚   โ”œโ”€โ”€ content/
โ”‚   โ”‚   โ””โ”€โ”€ scraper.ts             # Content script to scrape product info
โ”‚   โ”œโ”€โ”€ background/
โ”‚   โ”‚   โ””โ”€โ”€ background.ts          # Background service worker (MV3)
โ”‚   โ”œโ”€โ”€ App.tsx                    # Verdict popup UI
โ”‚   โ”œโ”€โ”€ main.tsx                   # React entry point
โ”‚   โ””โ”€โ”€ styles/                    # Tailwind CSS
โ”œโ”€โ”€ index.html                     # Popup HTML
โ”œโ”€โ”€ vite.config.ts                 # Vite + CRXJS build config
โ””โ”€โ”€ README.md                      # You're here!

๐Ÿง  How It Works

  1. You complete a short onboarding quiz
  2. Your skin profile is saved in chrome.storage.sync
  3. When visiting supported product pages, the extension:

    • Scrapes ingredients from the page
    • Compares them with your saved skin profile
    • Displays a personalized verdict in the popup

๐Ÿ›  Tech Stack


๐Ÿงช Run Locally

# Install dependencies
npm install

# Build for Chrome (outputs to /dist)
npm run build

# Load in Chrome:
# 1. Visit chrome://extensions
# 2. Enable Developer Mode
# 3. Click "Load unpacked"
# 4. Select the /dist folder

๐Ÿ“ฆ Scripts

Command Description
npm run dev Launches dev server for pages
npm run build Builds extension for production

๐ŸŒฑ Future Roadmap


๐Ÿš€ Built with โค๏ธ by Soumyodeep Dey For Privacy-Policy Click Here