Skip to content
ysultankpgPublic

About

Namesake — Choose the Perfect Name. Discover the meaning, origin and legacy behind 14,000+ Islamic and Arabic names.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

9 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Namesake — Choose the Perfect Name

Discover the meaning, origin and legacy behind any name in the Ummah


What is Namesake?

Namesake is a client-side web app for discovering Islamic and Arabic name meanings. It serves 14,000+ names fetched at runtime from a public HuggingFace dataset, enriched with 44 hand-curated entries for Prophets and Companions — each with verified Quranic ayat (Arabic + Muhsin Khan & Hilali translation), Hadith references, and historical context.

No backend required. No API keys. Everything runs in your browser.

Live: ysultankpg.github.io/namesake


Features

  • 14,000+ Names — fetched from HuggingFace at runtime
  • 25+ Prophets & 15+ Companions — curated with Quranic references and fun facts
  • Arabic Script — rendered natively with Noto Naskh Arabic font (RTL, proper letter joining)
  • Fuzzy Search — finds names even with typos using Levenshtein distance matching
  • Islamic Significance — Quranic ayat in Arabic + English (Muhsin Khan & Hilali) linked to name meanings
  • Disclaimer — clearly marks non-premium references as virtue-based, not direct name mentions
  • Random Boy / Girl — gender-filtered random name discovery
  • Category Browsing — quick-access pills for Prophets, Companions, Boys, Girls
  • Downloadable Cards — beautiful PNG cards generated client-side via Canvas API
  • Share — native Web Share API integration
  • Dark / Light / System — theme switcher matching portfolio design system
  • Bento Stats — live count of total names, prophets, companions, and Arabic-scripted names
  • Similar Names — clickable related names for exploration
  • Name Details — letter count, syllables, origin
  • Fully Static — no backend, no database, no server — just HTML, CSS, JS

Tech Stack

Layer Technology
Data source HuggingFace Datasets API
Premium data 44 hand-curated entries in data.js
Card generation Browser Canvas API (1080x1350 PNG)
Arabic rendering Noto Naskh Arabic font + native RTL
Search Prefix match + substring + Levenshtein distance
Fonts Outfit (UI) + Noto Naskh Arabic (Arabic script)
Hosting GitHub Pages

Project Structure

namesake/
  index.html   — Main page (hero, search, categories, result card, features)
  style.css    — Design system (dark/light themes, glass morphism, orbs, animations)
  data.js      — Premium enrichment data (Prophets, Companions) + HF dataset URL
  app.js       — Theme switching, data loading, search, display, Canvas card generation

Islamic Integrity

  • No numerology, astrology, or any haram content
  • Quranic references use the Muhsin Khan & Taqiuddin Al-Hilali translation
  • Non-premium names show a clear disclaimer that verses relate to the virtue of the meaning, not a direct Quranic mention of the name
  • All Prophet and Companion references are manually verified

Setup

No build step required. Just open index.html in a browser, or deploy to any static host.

# Local
open index.html

# Or serve locally
python3 -m http.server 8080

Credits


License

MIT


Built with love for the Ummah

About

Namesake — Choose the Perfect Name. Discover the meaning, origin and legacy behind 14,000+ Islamic and Arabic names.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages