Project: Creative Apps- PuzzleQuest #40
Description
Track
Creative Apps (GitHub Copilot)
Project Name
PuzzleQuest
GitHub Username
Repository URL
https://github.com/prakash6018/PuzzleQuest.git
Project Description
A mobile/web puzzle game that auto-generates endless riddles, mazes, and escape rooms themed around your interests. Features a Claude-powered AI "Riddle Master" chatbot with an evolving personality that adapts to your skill level.
Demo Video or Screenshots
Primary Programming Language
TypeScript/JavaScript
Key Technologies Used
Frontend: React 19 + Vite 7 + React Router
- Backend: Express 5 + Node.js
- AI: Anthropic Claude SDK (Claude Sonnet)
- Maze Generation: DFS recursive backtracker on HTML5 Canvas
- Storage: localStorage (client-side persistence)
Submission Type
Individual
Team Members
No response
Submission Requirements
- My project meets the track-specific challenge requirements
- My repository includes a comprehensive README.md with setup instructions
- My code does not contain hardcoded API keys or secrets
- I have included demo materials (video or screenshots)
- My project is my own work with proper attribution for any third-party code
- I agree to the Code of Conduct
- I have read and agree to the Disclaimer
- My submission does NOT contain any confidential, proprietary, or sensitive information
- I confirm I have the rights to submit this content and grant the necessary licenses
Quick Setup Summary
Clone the Repository
Open your terminal and run:
git clone https://github.com/prakash6018/PuzzleQuest.git
cd PuzzleQuest
This downloads the project to your local machine and moves into the project folder.
2️⃣ Install Dependencies
Run the following command to install all required packages:
npm install
This will install both frontend and backend dependencies listed in package.json.
3️⃣ Start the Frontend Development Server
Start the frontend by running:
npm run dev
After it starts, the terminal will show a local URL (usually something like):
Open that URL in your browser to view the app.
4️⃣ Start the Backend Server
In a new terminal window (inside the project folder), run:
node server/index.js
Make sure Node.js is installed on your system before running this.
5️⃣ Configure Environment Variables (If Required)
If the project uses environment variables:
Copy the example file:
.env.example → .env
Update the values inside the .env file as needed.
Technical Highlights
AI-Driven Riddle Master: Integrating the Anthropic Claude SDK to create a dynamic "Riddle Master" chatbot that adapts its personality and difficulty based on player performance is a standout feature. This adds replay value and a personalized experience.
Procedural Content Generation: The use of a DFS recursive backtracker algorithm for maze generation ensures each playthrough is unique, providing endless puzzle variations without manual content creation.
Modular Architecture: The clear separation between backend (Express server for API, AI, and game logic) and frontend (React for UI/UX) makes the codebase maintainable and scalable.
Theme-Based Personalities: Giving the Riddle Master unique personas for each theme (e.g., NEXUS-7 for Sci-Fi, Chronos the Sage for History) adds depth and immersion, making the AI feel more engaging.
Progressive Difficulty & Adaptive Hints: The system tracks win rates and streaks to adjust riddle difficulty and hint generosity, keeping the game challenging but fair for all skill levels.
Mobile-Responsive Design: Ensuring the app works seamlessly on both desktop and mobile broadens accessibility and user reach.
Client-Side Persistence: Using localStorage for progress tracking (XP, levels, streaks) allows users to continue where they left off without requiring accounts.
Challenges & Learnings
No response
Contact Information
Country/Region
India