Skip to content

ghulamrasoolshirzai2003/Project-Faseeh

Repository files navigation

🏆 Project Faseeh: Web-Based Arabic Hangman Game

Silver Medalist – Innovation Competition 2025

Project Faseeh is an award-winning, interactive educational platform designed to gamify the process of learning the Arabic language. By blending traditional Hangman logic with a modern full-stack architecture, it provides a high-engagement environment for students and language enthusiasts.

🚀 Project Overview

Faseeh (meaning "Eloquent" in Arabic) was developed to bridge the gap between traditional rote learning and modern interactive technology. The system features a robust administrative backend, real-time progress tracking, and an immersive user interface.

✨ Key Features

  • Gamified Learning: Classic Hangman mechanics adapted for Arabic vocabulary.
  • Progressive Difficulty: Multiple levels (Level Select) to cater to different learning stages.
  • Real-time Leaderboard: Integrated API to track and display top student rankings.
  • Admin Dashboard: Comprehensive control panel for managing word banks, user progress, and system health.
  • Visual Feedback: Dynamic SVG animations (Hangman stages) and GIF feedback for victory or loss.
  • Sound Integration: High-quality audio cues for correct/wrong answers and game outcomes.

🛠️ Technical Stack

  • Frontend: HTML5, CSS3 (Custom Responsive Design), JavaScript (ES6+).
  • Backend: PHP (Server-side logic and session management).
  • Database: SQL (MySQL) for word storage, user profiles, and ranking data.
  • API Layer: Custom PHP endpoints for leaderboard data and game state synchronization.
  • Graphics: Scalable Vector Graphics (SVG) for lightweight, crisp game assets.

📁 Project Structure

├── admin/               # Administrative dashboard and analytics
├── api/                 # PHP endpoints for game logic & leaderboard
├── assets/              
│   ├── css/             # Custom stylesheets
│   ├── images/          # Dynamic SVG hangman assets and UI gifs
│   ├── js/              # Game engine (game.js)
│   └── sounds/          # Audio feedback files
├── includes/            # Core DB connection and session logic
├── index.php            # Main entry point
└── database.sql         # Database schema for deployment

🎖️ Awards & Recognition Silver Medal: Awarded for excellence in educational technology and innovation at the 2025 Innovation Competition.

👨‍💻 Developer Ghulam Rasool Shirzai Portfolio | LinkedIn

About

A gamified educational platform for Arabic language learning. Developed using a PHP/MySQL backend with custom API endpoints for progress tracking and leaderboard management.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors