Project: Creative Apps- PuzzleQuest

Track

Creative Apps (GitHub Copilot)

Project Name

PuzzleQuest

GitHub Username

@prakash6018

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):

http://localhost:5173

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

prakashreddy8689@gmail.com

Country/Region

India

This issue is a project submission rather than a scoped contribution. Review README.md and package.json first, then run npm install, npm run dev, and node server/index.js; no specific change or acceptance criterion is provided, so completion cannot be defined without a new request.