Overview

This PR adds a complete graphical user interface (GUI) for the Number Guessing Game using Java Swing, as requested in #[issue_number]. The game now launches with a modern, user-friendly GUI by default, while maintaining backward compatibility with the console mode.

Screenshot

What's New

🎮 GUI Mode (Default)

• Modern Interface: Clean Swing-based GUI with professional layout and spacing
• Visual Feedback: Color-coded hints for game progress:
  • 🔵 Blue text when guess is too low
  • 🟠 Orange text when guess is too high
  • 🟢 Green text for correct guess
• Real-time Stats: Guess counter updates automatically
• Menu System:
  • File menu with New Game (Ctrl+N) and Exit options
  • Help menu with About dialog showing version and project info
• Input Validation: Helpful error messages for invalid input
• Congratulations Dialog: Shows completion message with guess count

💻 Console Mode Preserved

The classic console interface remains available using the --console or -c flag:

java -jar app.jar --console

Technical Details

Implementation

• Architecture: GUI class extends JFrame following Swing best practices
• Layout: Uses BoxLayout for responsive, cross-platform design
• Thread Safety: GUI creation wrapped in SwingUtilities.invokeLater()
• Code Reuse: Leverages existing game logic classes (RandomNumber, CheckGuess, GameInfo)
• No New Dependencies: Built entirely with Java standard library (Swing/AWT)

Files Changed

• GUI.java: Complete rewrite from placeholder to full implementation
• Main.java: Enhanced to support both GUI and console modes
• README.md: Updated with GUI documentation and usage instructions

Testing

• ✅ All existing tests continue to pass
• ✅ New unit tests added for GUI and Main classes
• ✅ CodeQL security scan: 0 alerts
• ✅ Manual testing confirms cross-platform compatibility

Cross-Platform Compatibility

The GUI is designed to work seamlessly across Windows, macOS, and Linux:

• Uses platform-independent Swing components
• Proper font and layout scaling
• All resources bundled in JAR file
• No external dependencies or configuration files needed

Usage

GUI Mode (Default):

java -jar app.jar
# or use the generated scripts
./bin/app        # Linux/Mac
bin\app.bat      # Windows

Console Mode:

java -jar app.jar --console

Documentation

The README has been updated with:

• Feature list with emoji indicators
• Detailed usage instructions for both modes
• Screenshots and visual examples
• How to switch between GUI and console modes

Resolves #[issue_number]

Fixes #19

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.