Skip to content

maalikhassan/score_tracker

Repository files navigation

🎮 LUCK & LOGIC - Premium Score Tracker

A professional, feature-rich multiplayer game score tracking application with a modern, premium UI/UX design.

📁 Project Structure

score_tracker/
├── index.html              # Main HTML file with semantic structure
├── css/
│   └── styles.css         # All styling and animations
├── js/
│   ├── app.js             # Application entry point
│   ├── gameState.js       # Game logic and state management
│   └── uiController.js    # UI updates and event handling
├── assets/                # Images, icons, etc. (future use)
└── README.md              # This file

🎯 Key Features

Professional Multi-File Architecture

  • Separated concerns: HTML, CSS, JavaScript modules
  • Game logic decoupled from UI
  • Easy to maintain and scale

Premium UI/UX

  • Modern glassmorphism design with backdrop blur
  • Animated glowing effects and smooth transitions
  • Responsive design (desktop to mobile)
  • Advanced animations (shimmer, pulse, glow effects)

Seamless Gameplay

  • Quick preset point buttons (+1, +2, +3, +5, +10, -1)
  • Enter key support for fast input
  • Real-time score updates
  • Turn history with timestamps

Game Features

  • Unlimited players (up to 10 recommended)
  • Customizable winning score
  • Turn history with logs
  • Skip turn functionality
  • Progress percentage indicators
  • Live leaderboard

🚀 Quick Start

  1. Open the application:

    • Open index.html in a modern web browser
    • Or use a local server: python -m http.server or npx http-server
  2. Set up the game:

    • Enter winning score (default: 30)
    • Enter number of players (2-10)
    • Click "Set Player Names"
    • Enter player names
    • Click "Start Game"
  3. Play:

    • Click preset buttons or enter custom points
    • Click "Submit Turn" or press Enter
    • View live scores and turn history
    • Winner is declared when score reaches winning score
  4. New Game:

    • Click "Reset Game" to start over

🎨 Design Features

Color Theme

  • Primary: Neon Cyan (#00ffff)
  • Accent: Gold (#ffd700)
  • Secondary: Purple (#9a00ff)
  • Success: Green (#00ff41)
  • Alert: Red (#ff1155)
  • Background: Dark Blue (#0a0e27)

Premium Effects

  • Glassmorphism with backdrop blur
  • Neon glow shadows
  • Shimmer animations on cards
  • Pulse effects on borders
  • Smooth cubic-bezier transitions
  • Responsive hover states

Typography

  • Heading Font: Orbitron (futuristic, bold)
  • Body Font: Space Mono (clean monospace)
  • Professional letter-spacing and line-height

📱 Responsive Design

  • Desktop (>1200px): Two-column layout with sidebar
  • Tablet (768px-1200px): Single column responsive
  • Mobile (<768px): Touch-friendly buttons and inputs
  • Small Mobile (<480px): Optimized for narrow screens

🔧 Technical Stack

  • HTML5: Semantic markup
  • CSS3: Modern features (grid, flexbox, animations)
  • Vanilla JavaScript: No dependencies, modular architecture
  • Browser Support: Chrome, Firefox, Safari, Edge (modern versions)

📊 Game State Management

The GameState class handles:

  • Player initialization and management
  • Score tracking and updates
  • Turn history management
  • Winner detection
  • Leaderboard generation

🎮 UI Controller

The UIController class manages:

  • DOM element references
  • Event listeners
  • Screen transitions
  • Form validation
  • Real-time UI updates

🌟 Code Structure

gameState.js

  • Pure game logic
  • No DOM dependencies
  • Easily testable
  • Can be used standalone

uiController.js

  • DOM manipulation
  • Event handling
  • User interaction logic
  • Screen management

app.js

  • Initialization
  • Module coordination
  • Entry point

🔐 Best Practices Implemented

✅ Separation of Concerns ✅ DRY (Don't Repeat Yourself) ✅ Single Responsibility Principle ✅ Responsive Design ✅ Accessibility considerations ✅ Performance optimized ✅ Clean code standards

🎯 Future Enhancements

  • Local storage for game history
  • Dark/Light theme toggle
  • Sound effects and notifications
  • Export game statistics
  • Multiplayer online support
  • Custom themes and colors
  • Game presets (dice games, card games, etc.)
  • Performance metrics and statistics

📝 License

Created for INDUSTRY MINDS - ICET

🤝 Support

For issues or questions, please contact the development team.


Version: 1.0.0
Last Updated: November 2025
Status: Production Ready

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors