About this project

Gold Ticker Live is a bilingual (English and Arabic, with RTL support) static multi-page website that presents gold pricing and related tools for the UAE, the GCC, the wider Arab world and a few global reference markets. The public site is authored as vanilla ES modules with hand-written CSS and bundled for production with Vite. An optional Node/Express portion (server.js plus a server directory) supports the admin area — authentication, shop/order/content management and rate-limited API proxying — but the public pages are described as fully static and do not depend on it. Pricing and data layer The platform presents XAU/USD spot-linked prices that refresh on a 90-second cycle, converts them into local currencies for the supported markets, and applies karat purity to produce views for 24K, 22K, 21K, 20K, 18K, 16K and 14K. Documented sources include Gold-API.com for the live spot layer, ExchangeRate-API for currency conversion, a hardcoded 3.6725 AED/USD peg for UAE pricing, DataHub for historical baselines and the GDELT DOC API for news headlines. The README also documents the conversion constant (1 troy ounce = 31.1034768 grams), formulas for per-gram and per-ounce karat prices, and notes that rounding happens only at the display boundary. It states explicitly that figures are spot-linked bullion-equivalent estimates rather than final retail prices, since making charges, dealer premiums, VAT and shop markups are not included. Data flows through shared library modules for fetching, dual-layer localStorage caching, price calculation and formatting. Workspaces and tools The Tracker is a multi-mode workspace covering Live, Compare, Archive, Alerts, Planner, Exports and Method views. A calculator suite includes gold value, scrap gold, zakat, buying power and weight-unit conversion (grams, troy ounces, tola, baht, mithqal). Other pages include a shop directory browsable by country, city and market; an order-gold flow for 1g–100g bars across karats with live pricing and UAE VAT; price history and date lookup; bilingual search; investment-return and zakat calculators; an embeddable ticker widget; guides; and country pages covering roughly 15 countries and 45+ cities. Outputs and automation CSV and JSON exports, shareable URL state, browser-based alerts and saved presets are provided. The site is described as PWA-ready and offline-friendly, using a service worker and local-first storage. The README lists eight automated workflows for social posting and related tasks, including posting to X/Twitter, Telegram and Discord, spike alerts and uptime monitoring, plus an auto-generated RSS feed for price updates. Development and quality The project documents running the site without a build via a static file server, or with Vite for HMR, plus build, preview and lint/validate/quality/preflight script targets, a per-page debug mode, a documented environment-variable matrix for the admin backend, and a GitHub-based workflow setup. It is licensed under Apache-2.0.