# Nusuk Keys (مفاتيح نسك)
> Free, community-verified directory of challenge referral keys for the official Saudi Nusuk Umrah App (services.nusuk.sa).

## Overview
- **Project Name**: Nusuk Keys
- **Canonical URL**: https://keys-nusuk.vercel.app/
- **Official Destination**: https://services.nusuk.sa
- **Purpose**: Helps pilgrims worldwide discover, verify, and share challenge referral keys (`NG-...`) to unlock Umrah milestones and badges in the Saudi Nusuk application.

## Key Information
- **Format**: `NG-[A-Za-z0-9_-]+` (case-insensitive, typically uppercase 6-24 characters, e.g., `NG-SBs90X`, `NG-UMR2026`).
- **Nature of Keys**: These codes are timeless challenge referral codes for pilgrims completing the Umrah challenge in the Nusuk app. They can be used by any pilgrim who has not yet claimed them.
- **Deep Link Pattern**: `https://services.nusuk.sa/app?p=27&id={CODE}` opens the Nusuk mobile app directly to the challenge activation page.
- **Spiritual Motivation**: Dropping and sharing active challenge keys acts as a continuing good deed (Sadaqah Jariyah) assisting pilgrims during their sacred Umrah journey, following Surah Al-Ma'idah 5:2 and Sahih Muslim 2699.

## Capabilities & Architecture
- **Tech Stack**: Next.js 14 (App Router), Tailwind CSS, Framer Motion, Supabase PostgreSQL with real-time replication.
- **Security**: Sliding-window rate-limiting (anti-spam), client & database duplicate rejection with PostgreSQL unique constraints, XSS and injection sanitization.
- **Performance**: 100% self-hosted fonts, zero external render-blocking scripts, Vercel Edge CDN distribution.
- **Bilingual**: English (LTR) and Arabic (RTL) with native Nasta'liq and Amiri typography.

## Links & Documentation
- [Nusuk Keys Homepage](https://keys-nusuk.vercel.app/): Main interactive challenge keys directory.
- [Arabic Version](https://keys-nusuk.vercel.app/?lang=ar): دليل مفاتيح ورموز تحدي نسك باللغة العربية.
- [Full Technical Documentation](https://keys-nusuk.vercel.app/llms-full.txt): Complete LLM context and architecture documentation.
- [Official Saudi Nusuk Platform](https://services.nusuk.sa): Official Umrah and Hajj government portal.
- [Sitemap](https://keys-nusuk.vercel.app/sitemap.xml): XML sitemap for search and indexing engines.