secret-santa-riddle-quest

This is fun project created while playing secret santa in office. Which generate riddles and upon answering them reveals place where gift hidden.

Comment

Inspiration

Secret Santa events are fun, but the reveal is usually too direct — you simply get a name and the mystery disappears. I wanted to make the reveal itself feel like a game. The idea was to transform a simple Secret Santa assignment into an interactive riddle quest where curiosity, guessing, and surprise are part of the experience. By combining personalization (name + place) with riddle generation, the reveal becomes playful instead of procedural.

What it does

Secret-Santa-Riddle-Quest is an app that:

  • Takes a participant’s name and place
  • Generates a personalized riddle quiz
  • Builds a secret reveal flow instead of showing the answer directly
  • Creates a shareable link for the recipient
  • Lets the recipient solve clues to discover their Secret Santa match

Instead of a plain assignment, users receive a mini puzzle experience.

How we built it

  • Designed a simple input flow for name and place
  • Created a riddle generation engine using:
    • letter clues
    • word patterns
    • location hints
    • template-based riddle structures
  • Built a quiz formatter that converts clues into progressive questions
  • Added encoded link generation so answers are not directly visible
  • Implemented validation and controlled reveal logic
  • Focused on lightweight architecture and fast generation time

Core pipeline:

User Input → Pattern Extraction → Riddle Templates → Quiz Builder → Shareable Secret Link

Challenges we ran into

  • Making riddles sound natural instead of mechanical
  • Generating variety using very limited input data
  • Balancing difficulty — not too easy, not too frustrating
  • Preventing the secret from being exposed through the link data
  • Designing a smooth user flow from input → share → solve → reveal
  • Avoiding repeated riddle patterns across different users

Accomplishments that we're proud of

  • Turning a simple Secret Santa reveal into an interactive game
  • Generating personalized riddles from minimal input
  • Creating a reusable riddle template system
  • Producing shareable secret links with hidden answers
  • Keeping the app lightweight and fast
  • Making the experience fun without needing complex setup

What we learned

  • Personalization greatly increases engagement
  • Even small inputs can generate rich experiences with the right templates
  • Riddle design requires linguistic creativity, not just logic
  • UX clarity matters more than feature count
  • Security-by-obscurity is not enough — even simple encoding needs thought
  • Iteration improves puzzle quality more than adding complexity

What's next for secret-santa-riddle-quest

  • AI-generated riddles for higher variety
  • Difficulty level selection
  • Theme packs (holiday, office, friends, kids)
  • Multi-participant group mode
  • Timed challenge mode
  • Hint unlock system
  • Voice and audio riddle clues
  • Leaderboard for fastest solvers
  • Localization for multiple languages

The goal is to evolve it from a fun utility into a full festive puzzle experience.

Built With

Share this project:

Updates