A modern, feature-rich web application for tracking Tarneeb card game scores and statistics

Tarneeb Score Tracker is a comprehensive web application designed to help players track their Tarneeb card game scores, statistics, and performance over time. Built with modern web technologies, it provides an intuitive interface for managing games, players, and detailed analytics.

• 📝 Add New Games: Create games with multiple rounds and detailed scoring
• ✏️ Edit Games: Modify existing games and update scores
• 🗑️ Delete Games: Remove games from the system
• 📸 Photo Proof: Upload multiple photos as game evidence
• 📅 Date Tracking: Organize games by date with automatic sorting

• 🏆 Tournament Brackets: Create and manage tournament brackets with multiple rounds
• 🎯 Multiple Tournaments: Support for multiple tournaments with separate management
• 📋 Team Format: Support for teams with 2 players per team
• 🏷️ Game Labels: Unique labels for each match (e.g., R16-M1, QF-M1, SF-M1, Final)
• 📸 Tournament Photos: Upload proof photos for tournament games
• ✏️ Edit Tournament Games: Click any match to edit teams and add results
• 🎨 Visual Bracket: Beautiful tournament bracket visualization with connecting lines
• 🔄 Auto-Advance: Winners automatically advance to next round

• 👥 Player Rankings: Score-based rankings with color-coded top performers
• 🏆 Team Rankings: Track team performance and statistics
• 📈 Win Rates: Calculate and display win percentages
• 🎯 Score Tracking: Total score accumulation across all games
• 🏅 Visual Rankings: Gold, silver, bronze indicators for top players/teams

• 🔑 Secure Login: Admin authentication system
• 📤 Export Data: Download game data as JSON
• 📥 Import Data: Restore data from JSON files
• ⚙️ Game Management: Full CRUD operations for games

• 📱 Responsive Design: Works on desktop, tablet, and mobile
• 🖼️ Photo Enlargement: Click to view full-size game photos
• 🎨 Modern UI: Clean, intuitive interface with smooth animations
• ⚡ Fast Performance: Optimized for quick loading and smooth interactions

🌐 Visit the Live Application

Experience the full functionality of the Tarneeb Score Tracker with real-time data and all features enabled.

• Frontend: HTML5, CSS3, JavaScript (ES6+)
• Backend: PHP 7.4+
• Data Storage: JSON files
• Photo Management: Multi-file upload system
• Styling: Custom CSS with modern design patterns

• PHP 7.4 or higher
• Web server (Apache/Nginx) or PHP built-in server
• Modern web browser

1. Clone the repository

   git clone https://github.com/yourusername/tarneeb.git
   cd tarneeb

2. Start the PHP development server

   php -S localhost:8001

3. Open your browser

   http://localhost:8001
   

1. Upload files to your web server
2. Set permissions for the assets/ directory (write access for photo uploads)
3. Configure PHP settings for file uploads if needed
4. Access your domain to start using the application

1. View Statistics: Check your ranking and performance metrics
2. Browse Games: Look through recent games and scores
3. View Photos: Click on game photos to see full-size images

1. Login: Use the "Admin Login" button to access admin features
2. Add Games: Click "Add New Game" to create new game entries
3. Manage Data: Use the menu to export/import data
4. Edit Games: Click the edit button on any game card
5. Delete Games: Remove games using the delete button

1. Navigate to Tournaments: Click the "Tournament" button on the main page
2. Select Tournament: Choose an existing tournament from the list or create a new one
3. Create Tournament: Admins can create a new tournament with a name (e.g., "2025 Championship")
4. Add Tournament Games: Click "Add Tournament Game" to add matches
   • Select the round (Round of 16, Quarterfinals, Semifinals, 3rd Place, Final)
   • Choose the match label (e.g., R16-M1, R16-M2, etc.)
   • Enter team names and players
   • Add rounds and scores (optional - can be added later)
   • Upload proof photos
5. Edit Matches: Click any match card to edit teams, players, or add results
6. View Bracket: See the complete tournament bracket with connecting lines showing progression

tarneeb/
├── 📄 index.php              # Main application entry point
├── 📄 index.html             # Main page (HTML version)
├── 📄 tournament.html        # Tournament bracket page
├── 📄 api.php                # Backend API endpoints
├── 📄 script.js              # Frontend JavaScript logic
├── 📄 styles.css             # Application styling
├── 📄 LICENSE                # License information
├── 📄 README.md              # This file
└── 📁 assets/
    ├── 📁 config/            # Secure configuration (environment variables)
    ├── 📄 games.json         # Game data storage (includes tournament games)
    ├── 🖼️ favicon.png        # Site favicon
    ├── 🖼️ slickml.png        # SlickML logo
    └── 📁 photos/            # Uploaded game photos
        └── 🖼️ *.jpg          # Game proof photos

• Score-Based Rankings: Players and teams are ranked by total accumulated score
• Visual Indicators: Top 3 players/teams get special color coding
• Circular Rank Numbers: Easy-to-see ranking indicators on cards

• Multiple Uploads: Add several photos per game
• Photo Enlargement: Click any photo to view full size
• Delete Photos: Remove unwanted photos when editing games
• Proof System: Photos serve as evidence for game results

• Win Rates: Percentage of games won
• Total Scores: Cumulative score across all games
• Game Counts: Total games played
• Recent Activity: Latest games with detailed round scores

The application uses a simple authentication system. Admin credentials can be configured in the JavaScript code.

Ensure your PHP configuration allows file uploads and has sufficient upload_max_filesize and post_max_size settings.

We welcome contributions! Here's how you can help:

1. 🐛 Report Bugs: Found an issue? Let us know!
2. 💡 Suggest Features: Have ideas for improvements?
3. 🔧 Submit Pull Requests: Help us improve the code
4. 📖 Improve Documentation: Help others understand the project

This project is licensed under the MIT License - see the LICENSE file for details.

• SlickML: Powered by SlickML for enhanced functionality
• Community: Thanks to all users and contributors
• Tarneeb Players: For inspiring this score tracking solution

• 🌐 Live Demo: tarneeb.amirhessam.com
• 📧 Issues: Report problems via GitHub Issues
• 💬 Discussions: Join the conversation in GitHub Discussions