Skip to main content
Gamma Coin
@swiftware/gamma-sdk · v1.1.0

GammaSDK

Coins, cloud save, and player profiles for your game on Gamma Games — in a few typed lines.

Get started⚡ Integrate with AI
npm install @swiftware/gamma-sdk
  • ~6 KBminified
  • 7methods
  • 0API keys
~0 KB
minified
0 methods
tiny API surface
0 KB
cloud save / game
0
API keys needed

Everything in one tiny package

Six primitives, one import

Coins

Read, spend, and award the player's Gamma Coins. Server-authoritative and atomic — grant rewards only when the result is ok.

Cloud save

Account-bound progress that syncs across devices, with an automatic localStorage fallback and one-shot migration.

Coin value

One canonical coin value (USD-per-coin + display metadata) shared by every game, plus coinsToUsd / formatCoins helpers.

Player profile

Personalise with the player's public display name, avatar, and frame — never any sensitive data.

Safe & app-only

Coins only work inside the app and can't be cheated. Outside it the SDK is inert by default — one build runs everywhere.

Dev mock

Build and test in a plain browser with an opt-in local mock — same API, same validation, zero risk to real balances.

One API

Everything your game needs, nothing it doesn’t

The whole surface is a handful of promise-first calls. No SDK keys, no config files, no boilerplate — import, await, ship.

  • ✓Server-authoritative coins you can’t cheat
  • ✓Cloud save with automatic offline fallback
  • ✓Fully typed — autocomplete every call
Browse the API
Spend coins
await gamma.spendCoins(50, 'life')
Cloud save
await gamma.storage.save(state)
Award coins
await gamma.awardCoins(100)
Player profile
const me = await gamma.getPlayer()
Coin value
gamma.coinsToUsd(250)
Dev mock
gamma.useMock({coins: 500})

How it works

From install to first coin

  1. 1Wait for ready
    One await settles the bridge — the real host in-app, or a safe fallback outside it.
  2. 2Load the save
    gamma.storage syncs to the account in-app and falls back to localStorage offline.
  3. 3Use coins
    Spend and earn the player’s real coins. Grant the reward only when ok is true.
game.js — step 1
import {gamma} from '@swiftware/gamma-sdk';

await gamma.ready();
console.log(gamma.isInApp);

Sound familiar?

How do I save progress across devices?
Can I use the player’s real coins?
How do I test outside the app?
Do I need to manage API keys?
What happens when the player is offline?
How big is this going to make my bundle?
How do I save progress across devices?
Can I use the player’s real coins?
How do I test outside the app?
Do I need to manage API keys?
What happens when the player is offline?
How big is this going to make my bundle?

GammaSDK answers every one of these — server-authoritative coins, cross-device cloud save, a local dev mock, and zero keys to manage.

Start integrating

AI-native docs

Let your AI tool do the integration

Copy one self-contained prompt into Claude, ChatGPT, Cursor, or Copilot and let it wire the SDK into your game. Every page is copyable as Markdown, and the whole site is published as llms.txt.

Works withChatGPT, Claude, and Perplexity
Open the AI promptOr integrate manually

Ready when you are

Ship your game.
Earn real coins.

Install the package, wait for ready(), and start awarding the player real Gamma Coins. Free, typed, and no API keys.

Get startedAPI reference