Contributing to Game Framework

# Clone repository
git clone https://github.com/xraph/gameframework.git
cd gameframework

# Install dependencies
make bootstrap

# Run tests
make test

# Run static analysis
make analyze

# Clone repository
git clone https://github.com/xraph/game-cli.git
cd game-cli

# Install dependencies
dart pub get

# Build and install
make install

# Run tests
make test

# Fork the repo on GitHub, then:
git clone https://github.com/YOUR_USERNAME/gameframework.git
cd gameframework

# Add upstream remote
git remote add upstream https://github.com/xraph/gameframework.git

git checkout -b feature/your-feature-name
# or
git checkout -b fix/bug-description

# Run tests
make test

# Run static analysis
make analyze

# Format code
make format

# Test on actual devices if possible
flutter run

# Good commit messages:
git commit -m "feat: Add WebGL support for Unity plugin"
git commit -m "fix: Resolve memory leak in Android controller"
git commit -m "docs: Update Unity integration guide"

# Format:
# type(scope): subject
#
# Types: feat, fix, docs, test, refactor, style, perf, chore

git push origin feature/your-feature-name

// ✅ Good
class GameEngineController {
  /// Creates a game engine controller.
  GameEngineController({
    required this.engineType,
    this.config = const GameEngineConfig(),
  });

  final GameEngineType engineType;
  final GameEngineConfig config;

  /// Sends a message to the game engine.
  Future<void> sendMessage(String target, String method, String data) async {
    // Implementation
  }
}

// ❌ Bad
class game_engine_controller {
  game_engine_controller(this.engineType, [this.config]);
  var engineType;
  var config;
  sendMessage(target, method, data) {}
}

/// A unified widget for embedding game engines in Flutter.
///
/// This widget provides a common interface for displaying game engines
/// like Unity and Unreal Engine within a Flutter application.
///
/// Example:
/// ```dart
/// GameWidget(
///   engineType: GameEngineType.unity,
///   onEngineCreated: (controller) {
///     controller.sendMessage('GameManager', 'Start', 'level1');
///   },
/// )
/// ```
class GameWidget extends StatefulWidget {
  // ...
}

import 'package:flutter_test/flutter_test.dart';
import 'package:gameframework/gameframework.dart';

void main() {
  group('GameEngineConfig', () {
    test('should create with default values', () {
      const config = GameEngineConfig();
      expect(config.fullscreen, false);
      expect(config.runImmediately, false);
    });

    test('should serialize to map correctly', () {
      const config = GameEngineConfig(fullscreen: true);
      final map = config.toMap();
      expect(map['fullscreen'], true);
    });
  });
}