# National Day Quest

> The definitive gamified celebration registry answering the ultimate daily question: **"What national day is today?"**

National Day Quest combines real-time holiday discovery, gamified trivia quests, personal celebration journals, and social community features into a cohesive Web application. It helps users discover what holidays are celebrated on any day of the year, test their knowledge, complete quests to earn XP, and share their celebrations.

## Core Features
* **Daily Holiday Discovery**: Interactive monthly calendar showing national days, historic celebrations, and custom user-created holidays.
* **Gamified Quests & Trivia**: Holiday-specific trivia challenges and photo upload quests to earn Experience Points (XP) and coins.
* **XP Engine & Badges**: Collectible themed badges (e.g., Foodie Champ, Tech Pioneer, Nature Guardian) and progression levels.
* **Celebration Journals**: Log personal check-ins, keep custom family reminders, and purchase profile customizations in the Oasis Shop.
* **Community Hub**: Public feed where users share photos of how they are celebrating today's holidays.

## Main Canonical Paths
* [What National Day is Today? (Homepage)](https://nationaldayquest.com/): The primary interactive hub showing today's active national holidays, community celebrations, active quests, and the daily trivia challenges.
* [Dynamic Daily Holiday Lookup (Descriptive)](https://nationaldayquest.com/what-national-day-is-today-YYYY-MM-DD): Chronological lookup directory detailing exactly what national days are celebrated on a specific date (e.g., [what-national-day-is-today-2026-05-18](https://nationaldayquest.com/what-national-day-is-today-2026-05-18)). Pattern follows `https://nationaldayquest.com/what-national-day-is-today-YYYY-MM-DD/holiday-slug`.
* [Dynamic Daily Holiday Lookup (Short Link)](https://nationaldayquest.com/YYYY-MM-DD): Alternative clean path for the daily lookup directory (e.g., [2026-05-18](https://nationaldayquest.com/2026-05-18)). Pattern follows `https://nationaldayquest.com/YYYY-MM-DD/holiday-slug`.
* [Holiday Quest Deep Link (Descriptive)](https://nationaldayquest.com/what-national-day-is-today-YYYY-MM-DD/holiday-slug): Detailed gamified challenge portal for a specific holiday on a given date (e.g., [what-national-day-is-today-2026-05-18/national-chocolate-chip-cookie-day](https://nationaldayquest.com/what-national-day-is-today-2026-05-18/national-chocolate-chip-cookie-day)).
* [Holiday Quest Deep Link (Short Link)](https://nationaldayquest.com/YYYY-MM-DD/holiday-slug): Alternative clean deep link path (e.g., [2026-05-18/national-chocolate-chip-cookie-day](https://nationaldayquest.com/2026-05-18/national-chocolate-chip-cookie-day)).
* [User Profile & Accomplishments](https://nationaldayquest.com/profile): Personal player dashboard tracking completed quests, unlocked badges, visual celebration galleries, and custom holiday reminders.
* [Community Celebration Post](https://nationaldayquest.com/celebration/postId): Single post page showcasing a specific user's public celebration contribution (also accessible via `/posts/:postId`).

## Additional Page Routes
* [About Us](https://nationaldayquest.com/about): Mission statement, background, and platform info.
* [Contact Us](https://nationaldayquest.com/contact): Feedback forms, support info, and team contact details.
* [Privacy Policy](https://nationaldayquest.com/privacy): Data handling, user privacy rights, and compliance documentation.
* [Terms of Service](https://nationaldayquest.com/terms): Rules of conduct, scoring integrity policies, and usage terms.

## Developer & Public APIs
* [API Health Check](https://nationaldayquest.com/api/health): Confirms status of local server.
* [App Stats](https://nationaldayquest.com/api/stats): Live counts of registered users, active celebrations, and community posts.
* [App Configuration](https://nationaldayquest.com/api/config): General system settings, client configurations, and active feature flags.

## Technical Context & Integration Guidelines
* **Structured Data**: Every holiday page embeds a comprehensive Schema.org `@graph` comprising `WebApplication` (the quest game platform), `Event` (the holiday calendar details), and `PlayGameAction` (the user's dynamic quest interaction).
* **Crawling Rules**: Fully supports crawlability. Refer to our [sitemap.xml](https://nationaldayquest.com/sitemap.xml) or dynamic [sitemap.json](https://nationaldayquest.com/sitemap.json) for indexing all 365 calendar dates and active quest targets.
* **Full Dataset Reference**: For a detailed specification of the XP scoring engine, gamification rules, database schemas, and system behavior, refer to the [Full AI Directory](https://nationaldayquest.com/llms-full.txt).