Skip to content

README.md

Latest commit

 

History

History
193 lines (139 loc) · 5.3 KB

README.md

File metadata and controls

193 lines (139 loc) · 5.3 KB

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 🌍