# llms-full.txt — RoyaleGuess Complete Information
# https://royaleguess.com
# Last Updated: 2025-11-22

## OVERVIEW
RoyaleGuess is a simple yet rewarding daily Clash Royale card guessing game. Every day brings a brand new card, and players need to figure out which one it is from different clues. The game offers multiple challenge modes: Pixel, Classic, and Description. Each mode provides different information to help solve the puzzle.

### Gameplay Modes
1. **Classic Mode** - Progressive hints reveal card attributes (type, rarity, elixir cost, release year)
2. **Pixel Mode** - Guess from pixelated, blurred images that gradually become clearer
3. **Description Mode** - Receive partial words from the card's official description
4. **Emoji Mode** - Guess from emoji clues
5. **Practice Mode** - Unlimited practice with random cards
6. **Lives Mode** - Challenge yourself with limited lives

### Gameplay Hints (Classic Mode)
1. Type (Troop / Spell / Building)
2. Rarity (Common / Rare / Epic / Legendary / Champion)
3. Elixir cost range (e.g., 2–4)
4. Release year
5. Reveal the answer

## PAGES & ROUTES

### Main Pages
- / — Homepage with game mode selection
- /daily — Daily challenge (redirects to /daily/YYYY-MM-DD)
- /daily/YYYY-MM-DD — Static daily puzzle page
- /leaderboard — Global top players by speed & accuracy
- /archive — Past daily challenges archive

### Information Pages
- /how-to-play — Complete guide on how to play RoyaleGuess
- /what-is-royaleguess — Overview of what RoyaleGuess is
- /faq — Frequently asked questions
- /about — About page and credits
- /contact-us — Contact information and form
- /terms-of-service — Terms of service
- /privacy-policy — Privacy policy

### Game Mode Pages
- /classic — Classic mode with progressive hints
- /pixel — Pixel mode with pixelated images
- /description — Description mode with partial text
- /emoji — Emoji mode with emoji clues
- /practice — Practice mode (unlimited)
- /lives — Lives mode (limited lives)

### User Pages
- /login — User authentication
- /profile — User profile (requires login)
- /u/[username] — Public user profile
- /feedback — Feedback and support
- /feedback/my — User's feedback history

### Card Pages
- /cards/[cardId] — Individual card detail pages

## TECHNICAL STACK
- Framework: Next.js 15 (App Router) + TypeScript
- Styling: Tailwind CSS (mobile-first, responsive design)
- Database: Cloudflare D1 (scores, guesses, streaks, card metadata, user progress)
- Hosting: Cloudflare Pages (edge runtime)
- API: Clash Royale official API for card data
- Authentication: NextAuth.js
- Caching: Cloudflare caching for static assets and pages
- Security: HTTPS only; rate limiting for API endpoints; server-side API keys

## FEATURES
- Daily card challenge refreshed at UTC 00:00
- Multiple game modes (Pixel, Classic, Description, Emoji, Practice, Lives)
- 5 guess attempts with progressive hints (Classic mode)
- Global leaderboard with speed and accuracy rankings
- Progress tracking and achievement system
- Social sharing capabilities
- Archive of past daily challenges
- User authentication and profile system
- Practice mode for unlimited training
- Static page generation for '/daily/YYYY-MM-DD'

## SEO & METADATA
- Title: "RoyaleGuess – Daily Clash Royale Card Guessing Game"
- Meta description: "Play a daily Clash Royale card guessing challenge with Pixel, Stats and Description modes. Guess the card, climb the leaderboard and track your progress."
- OpenGraph: Custom OG images and metadata
- Canonical links on all pages
- Sitemap and robots.txt auto-generated
- JSON-LD structured data (HowTo, FAQPage, WebApplication schemas)
- llms.txt and llms-full.txt for AI/LLM information

## MONETIZATION
- Non-intrusive ads on '/archive' and '/leaderboard' only
- No ads on the main daily puzzle page
- Optional "Support RoyaleGuess" button

## KEYWORDS
Primary: Clash Royale guessing game; Clash Royale daily challenge; guess the Clash Royale card; RoyaleGuess; daily Clash Royale puzzle
Secondary: Clash Royale quiz; Clash Royale card trivia; Clash Royale Wordle-style game; Clash Royale card guessing

## CONTACT
- Website: https://royaleguess.com
- Contact: https://royaleguess.com/contact-us
- Feedback: https://royaleguess.com/feedback
- Terms: https://royaleguess.com/terms-of-service
- Privacy: https://royaleguess.com/privacy-policy

## COMPLIANCE
- HTTPS enforced via Cloudflare
- Rate limiting on APIs
- Server-only storage of secret keys
- GDPR-compliant privacy policy
- Terms of service clearly defined

## DISCLAIMER
RoyaleGuess is an independent fan project. Clash Royale and all related trademarks are property of Supercell. This site is not affiliated with or endorsed by Supercell.

For the latest puzzle, visit https://royaleguess.com/daily.