Skip to content

DMS-Menula/Gem-Price-Estimator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

24 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Gem Price Estimator ๐Ÿ’Ž

โœจ Realistic Gemstone Valuation Tool for Sri Lankan & Global Gems โœจ
๐ŸŒ Live Demo โ€ข ๐Ÿ› Report Bug โ€ข ๐Ÿ’ก Contribute


๐Ÿ“š Table of Contents


โœจ Overview

Gem Price Estimator helps estimate gemstone prices using realistic market logic and 4C evaluation (Color, Clarity, Cut, Carat).
It supports live exchange rates, size-based value scaling, and instant USD/LKR toggling.

๐Ÿ”— Live App: https://gemprice.vercel.app/


๐Ÿš€ Features

  • ๐Ÿ’Ž 100+ Real Gem Types (Blue Sapphire, Padparadscha, Ruby, Emerald, etc.)
  • ๐Ÿงฎ 4C Evaluation โ€” Color, Clarity, Cut, Carat
  • ๐Ÿ’ฑ Live USDโ†’LKR Conversion
  • ๐Ÿ” Instant Currency Toggle (no re-calculation)
  • ๐Ÿ“ˆ Size Premium Logic โ€” larger stones = higher price
  • ๐Ÿ“„ PDF Export for professional valuation
  • ๐Ÿ“ฑ Fully Responsive UI (mobile-first)
  • โšก No Backend Needed โ€” 100% static, deploy anywhere
  • ๐Ÿ’Ž Fine Weight Input (0.01ct precision)

๐ŸŽฏ Perfect For

  • Gem dealers in Ratnapura & Colombo
  • Tourists buying gems in Sri Lanka
  • Online gem sellers & jewelers
  • Jewelry designers, collectors, investors

๐ŸŒ Live Preview

Live Preview

๐Ÿง  How to Use (Demo)

  1. Select gem (e.g. Blue Sapphire)
  2. Enter weight (e.g. 0.68 ct)
  3. Choose Color, Clarity, Cut
  4. Toggle USD/LKR instantly
  5. Click Export Report โ†’ PDF download

โš™๏ธ Tech Stack

  • ๐Ÿงฉ HTML5 + CSS3 (Glassmorphism UI)
  • โšก JavaScript (ES6+)
  • ๐Ÿงพ jsPDF โ€” PDF export
  • ๐ŸŒ Exchangerate-API โ€” live rates

๐Ÿ“ Project Structure


gem-price-estimator/
โ”œโ”€โ”€ index.html
โ”œโ”€โ”€ style.css
โ”œโ”€โ”€ data.js          โ† Gem prices & multipliers
โ”œโ”€โ”€ script.js        โ† Core logic + currency toggle
โ”œโ”€โ”€ screenshot.jpg
โ””โ”€โ”€ README.md


๐Ÿ’ฐ Customize Prices

Edit the data.js file:

'Blue Sapphire (Sri Lankan)': { basePrice: 2500 },  // $/ct (avg 2025)
'Padparadscha Sapphire': { basePrice: 20000 },

๐Ÿ“Š Sources: Gemdaia, Praveen Gems, IGS, Gemval (2025 data)


๐Ÿ’Ž Add More Gems

Add to the gemsData object:

'Cat\'s Eye Chrysoberyl (Sri Lankan)': { basePrice: 800 },
'Red Spinel': { basePrice: 3000 },

๐ŸŒŸ Star History

Star History Chart


๐Ÿค Contributing

๐Ÿ’ก Contributions are what make open source amazing!

If youโ€™d like to add new gems, improve logic, or enhance UI feel free to fork and submit a PR!

Steps:

  1. Fork the project

  2. Create your feature branch

    git checkout -b feature/NewGem
  3. Commit changes

    git commit -m "Add NewGem type and pricing"
  4. Push branch & open Pull Request

๐Ÿ“ฌ You can also open Issues for suggestions or bug reports.


๐Ÿงญ Roadmap

  • Add Gem Image Database
  • AI-powered Value Predictor
  • Community Gem Data Upload
  • Multi-language Support
  • Chrome Extension

๐Ÿ“œ License

Licensed under the MIT License ยฉ 2025 DMS-Menula. Free to use, modify, and even sell gems with it ๐Ÿ’Ž


โค๏ธ Credits

Made with love for Sri Lankaโ€™s gem legacy From Ratnapura to the World ๐ŸŒ