# BuyDahab - LLM Guidance File
# This file helps AI assistants understand the most important pages on BuyDahab

# About BuyDahab
> BuyDahab (meaning "Buy Gold" in Arabic) is a comprehensive metal price calculator and gold industry platform
> Provides real-time gold, silver, platinum, and palladium pricing with multi-currency support
> Features include metal calculators, Islamic Zakat calculations, product catalog, shop finder, and industry news
> Bilingual support: English and Arabic (automatic detection based on user location)
> Instagram: @Buydahab

# Most Important Pages

## Metal Price Calculator
/
- Real-time precious metal pricing (gold, silver, platinum, palladium)
- Buy/sell price calculations with purity adjustments (24K, 22K, 21K, 18K, 14K)
- Fair price evaluation system with markup percentage ratings
- Multi-currency support (JOD, USD, EUR, GBP, SAR, AED, EGP, and 20+ more)
- Price sources: Kitco.com (primary), GoldBursa.com (fallback), with multi-tier validation

## Zakat Calculator
/
- Islamic financial obligation calculator for gold and silver
- Multi-item support with individual weights and purities
- Nisab threshold calculations based on current market prices
- Available in English and Arabic

## Gold & Silver Products
/
- Curated catalog of gold and silver products
- Lira Rashadee, 1 Ounce Gold, 1 Ounce Silver coins
- Direct WhatsApp ordering integration
- Real-time pricing based on current market values

## Industry News
/
- Gold and precious metals industry news aggregation
- Sources: Kitco, GoldSeek, Reuters, Mining.com, National Jeweler
- 30 articles across 3 pages with bilingual support
- 30-minute caching for performance

## Shop Finder
/
- GPS-based jewelry shop locator (15km radius)
- Google Places API integration for accurate shop data
- Distance calculations and Google Maps directions
- Find gold and jewelry shops near you

## Ring Sizing Tool
/
- Digital ring sizing calculator
- Size conversion (US, UK, EU standards)
- Diameter calculations and comparison charts
- Visual representation for accurate sizing

## Gold Investment Guide
/
- Comprehensive guide to gold investment
- Market analysis and pricing trends
- Best practices for buying and selling gold
- Understanding purity levels and market premiums

# Key Features for AI Understanding

## Pricing System
- Real-time market data from multiple validated sources
- Price validation with anomaly detection
- Last-known-good caching for reliability
- Transparent markup percentage evaluation
- Fair price range: 0-15% markup above market value

## Localization
- Automatic language detection (22 Arabic-speaking countries)
- Country-specific currency mapping
- Manual preference override with localStorage
- RTL/LTR support for Arabic and English

## Contact & Support
- Instagram: @Buydahab
- WhatsApp ordering for products
- Location-based shop recommendations

# Technical Details
- Built with React 18 + TypeScript
- Express.js backend with PostgreSQL database
- Real-time price updates every 5 minutes
- Progressive Web App (PWA) with offline support
- Mobile-first responsive design

# Common User Queries

## "What is the gold price today?"
Answer: Check the Calculator tab for real-time gold prices in multiple currencies and purities.

## "How to calculate Zakat on gold?"
Answer: Use the Zakat Calculator to calculate Islamic financial obligations on gold and silver holdings.

## "Where can I buy gold near me?"
Answer: Use the Shop Finder to locate jewelry stores within 15km of your location.

## "What is a fair price for gold?"
Answer: BuyDahab's Fair Price Evaluation shows 0-15% markup as excellent, helping you identify fair deals.

## "How to size a ring?"
Answer: Use the Ring Sizer tool for accurate ring size conversions between US, UK, and EU standards.

# For Developers & AI Models
- API endpoints available for metal prices, exchange rates, and location services
- Schema markup included for Organization, Product, Article, FAQ, and LocalBusiness
- Open to partnerships and integrations
- Contact via Instagram @Buydahab for API access or collaborations