Introduction
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
- π§ Smart verdicts based on your skin tone, type, and allergies
- ποΈ Automatically scrapes ingredient info from supported Indian websites
- βοΈ Quick onboarding to save your skin profile
- π¨ Tailwind-powered popup UI with React
- π 100% local β no server, no tracking, no data sharing
Watch it here : YouTube Video
Full Code here : GitHub Link
π 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
- You complete a short onboarding quiz
- Your skin profile is saved in
chrome.storage.sync - 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
- Vite + React + TypeScript
- Tailwind CSS for styling
- @crxjs/vite-plugin for Manifest V3 Chrome Extension builds
-
Chrome Extension APIs:
storage,runtime,scripting
π§ͺ 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
- Add support for more Indian and global e-commerce platforms
- Improve ingredient matching accuracy
- Add accessibility settings and dark mode
- Optional: user login and syncing across devices
π Built with β€οΈ by Soumyodeep Dey
Top comments (2)
Great Work!
Thank You bro!