Your game. Our platform. One plug.

Sign up like any player. The moment you register a game, your account becomes a developer account and the Dev Console appears in the top bar.

Register in the Dev Console, or straight from the API. Set the Play URL to wherever your game is hosted — hosting stays entirely yours; the portal just links players to it.

curl -X POST $SUPABASE_URL/functions/v1/register-game \
  -H "Authorization: Bearer $YOUR_JWT" -H "apikey: $ANON_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Game",
    "slug": "my-game",
    "description": "One line that sells it.",
    "platforms": ["web", "pc"],
    "play_url": "https://mygame.example.com",
    "price_coins": 0,
    "score_mode": "highest",
    "max_score": 100000
  }'

You get back a game_id and a signing secret, and the platform provisions an isolated database schema (game_<id>) just for your game — its leaderboard and cloud saves never collide with anyone else's. Choose score_mode: highest (personal best), latest (overwrite) or cumulative (sum). max_score is the server-side sanity cap that rejects impossible submissions.

npm install @gameportal/sdk

import { GamePortal } from "@gameportal/sdk";

const portal = new GamePortal({
  supabaseUrl: "<platform API url>",
  supabaseAnonKey: "<platform anon key>",
  gameId: "<your game_id>",
  gameSecret: "<your signing secret>",
});

That object is your entire integration surface. Everything below is a method on it.

Players use the same account in your game as in every other game on the platform. No separate registration, no separate password.

await portal.signIn(email, password);       // or portal.signUp(...)

portal.onAuthStateChange((user) => {
  // show your game when user != null, your sign-in screen otherwise
});

One call. The SDK signs the payload (HMAC-SHA256 with your secret), adds a one-time nonce and a timestamp, and the platform verifies all of it server-side before the score can touch your leaderboard — replays, tampering and impossible scores are rejected.

const result = await portal.submitScore(finalScore);
// { ok: true, score: 4200, rank: 3 }  — after your game's score_mode is applied

const top = await portal.getLeaderboard(15);   // [{ rank, username, score, ... }]
const me  = await portal.getMyRank();          // { rank, score, total_players }

portal.onLeaderboardChange(() => {
  // fires in real time when any player's score changes — re-render here
});

Every game gets JSONB progress storage in its own schema. Shape it however you want, up to 256 KB per player.

await portal.saveProgress({ level: 7, upgrades: ["shield", "boost"] });
const save = await portal.loadProgress();

One wallet across the whole platform. Coins bought anywhere (Stripe, Apple, Google, PayPal — handled by the platform, not by you) can be spent in your game, and wallet credits arrive in your game in real time.

const { balance } = await portal.getWallet();

portal.onWalletChange((w) => {
  // fires instantly when an IAP webhook credits the player — grant the goods here
});

// Sell in-game items you defined in the Dev Console:
const items = await portal.getItems();
await portal.purchaseItem(itemId);

// Premium game? Gate it with two calls:
const owned = await portal.ownsGame();
if (!owned) await portal.purchaseGame();   // spends wallet coins, atomic server-side

Flip your game to Published in the Dev Console. It immediately appears in the game library with a ▶ Play now button pointing at your Play URL, a live leaderboard page, and your item store.