hoangsonww/PuzzleForge-Game-Hub

Unified Player Profile + Cross-Game Progression System

Open

#7 opened on Feb 6, 2026

View on GitHub
 (0 comments) (0 reactions) (1 assignee)TypeScript (5 forks)auto 404
bugdocumentationduplicateenhancementgood first issuehelp wantedquestion

Repository metrics

Stars
 (14 stars)
PR merge metrics
 (PR metrics pending)

Description

Wordle wins: 14 Sudoku solved: 9 Connections streak: 3 4. Achievement System (MVP)Starter achievements:🧠 First Win (any game)🔥 5 wins in a row📘 First Sudoku solved⚡ Solve Wordle in 3 guesses🧩 Master of All Games (win each game once)🛠️ Technical Approach (suggested)Frontend:Central ProfileContextStat update hooks per gameXP calculator utilityBackend (optional phase 2):/api/profile/api/achievementscloud sync support✅ Acceptance Criteria Unified profile stored & loaded globally XP + leveling logic implemented Home page progress dashboard Achievement tracking + UI Stats migrate cleanly from existing localStorage format Docs in FEATURES.md🌟 Why This MattersThis transforms PuzzleForge from:“a collection of fun puzzle games”into:“a sticky, progression-driven puzzle platform”which is how successful casual gaming platforms keep users coming back.Optional Future ExtensionsDaily challenges across gamesLeaderboardsCloud login & syncSeasonal events

Contributor guide

Research direction
Create a centralized PlayerProfile context with XP/leveling logic and achievement tracking; integrate stats from existing per game localStorage into the unified profile; build a progress dashboard on the home page; update game components to call profile hooks after each game; consider backend API endpoints for future cloud sync.
Tech stack
typescriptreacttailwindcssnodejs
Domain
full stack
Issue type
Feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-2 days
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
TypeScriptReactlocalStorageGit
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
70