What is Snappy Idioms Dot Com?

An interactive, language-learning experience. Snappy Idioms Dot Com uses imagination, context, and active practice to build fluency, not just memorisation.

Gridiron Playmaker Integration

Connect your standalone Gridiron game to the Mothership pearl economy

Goal: When players complete Gridiron Playmaker games, they earn pearls that sync with their Snappy Idioms account. This creates a unified reward system across all your games.

Generate Credentials

Quick Stats

Pearl Rate:10 pearls per win

Game Type:NFL Idioms

Difficulty:Medium-Hard

Security:HMAC SHA-256

Setup Instructions

📋 GRIDIRON PLAYMAKER INTEGRATION STEPS

STEP 1: Generate Credentials
- Click "Generate Credentials" button below
- Save the gameId and secretKey (you'll need these!)

STEP 2: Register in Supabase
Run this SQL in your Supabase SQL Editor:

INSERT INTO "GameDeveloper" (
    developer_name,
    developer_email,
    game_name,
    game_id,
    secret_key,
    base_pearl_rate,
    status
) VALUES (
    'Samuel Intuitive English',
    'samuel@intuitiveenglish.co.uk',
    'Gridiron Playmaker',
    'PASTE_YOUR_GAME_ID_HERE',
    'PASTE_YOUR_SECRET_KEY_HERE',
    10,  -- 10 pearls per win (higher because it's harder)
    'active'
);

STEP 3: Add SDK to Gridiron
1. Copy the MOTHERSHIP_SDK.js file to your Gridiron app
2. Import it in your HTML: <script src="mothership-sdk.js"></script>
3. Initialize with your gameId and secretKey

STEP 4: Hook Up Game Events
When player finishes game:
- Call mothership.reportCompletion()
- Pass: playerEmail, unique levelId, 'win' or 'loss'
- Display pearl reward to player

STEP 5: Test It!
1. Play a game on Gridiron
2. Check Supabase TransactionHistory table
3. Verify pearls were awarded
4. Check UserPearlBalance table

SECURITY NOTES:
⚠️ NEVER expose secretKey in client-side code
⚠️ In production, move API calls to a backend proxy
⚠️ Current implementation is for testing only

Integration Code Example

<!-- 1. Add this to your Gridiron Playmaker HTML -->
<script src="https://snappy-english-prod.base44.run/mothership-sdk.js"></script>

<script>
// 2. Initialize the SDK
const mothership = new MothershipSDK({
  gameId: 'YOUR_GAME_ID',
  secretKey: 'YOUR_SECRET_KEY',
  apiUrl: 'https://snappy-english-prod.base44.run/functions/gameAPISupabase'
});

// 3. When player completes a level (wins)
async function handleGameComplete(playerEmail, rollCount, ladders, snakes, idioms) {
  try {
    const result = await mothership.reportCompletion(
      playerEmail,
      `game_${Date.now()}`,  // Unique level ID per game
      'win',
      {
        timeSpent: Math.floor(Date.now() / 1000),
        difficulty: 'medium',
        totalRolls: rollCount,
        laddersHit: ladders,
        snakesHit: snakes,
        idiomsEncountered: idioms
      }
    );

    if (result.success) {
      // Show pearl reward to player
      alert(`You earned ${result.pearlsAwarded} pearls! New balance: ${result.newBalance}`);
    } else if (result.alreadyRewarded) {
      alert('You already got pearls for this game!');
    }
  } catch (error) {
    console.error('Failed to award pearls:', error);
    alert('Game completed, but pearl award failed. Contact support.');
  }
}

// 4. Get player's progress
async function loadPlayerProgress(playerEmail) {
  try {
    const progress = await mothership.getProgress(playerEmail);
    console.log('Player pearl balance:', progress.pearlBalance);
    console.log('Completed levels:', progress.completedLevels);
  } catch (error) {
    console.error('Failed to load progress:', error);
  }
}
</script>

Next Steps: Once integrated, test by playing a full game on Gridiron Playmaker. Check your Supabase TransactionHistory table to verify pearls were awarded correctly.