AllDle SDK

Report what your players did, and AllDle handles the rest: the daily lineup, the cross-game streak, and a share card that links back to you. Ten lines, no account on your side, version 0.1.0.

Install

One script tag. It exposes a global AllDle.

<script src="https://www.alldle.net/sdk.js"></script>

For production, pin the version — this one never changes and is cached for a year:

<script src="https://www.alldle.net/sdk/0.1.0/sdk.js"></script>

Connect and report a result

connect() waits for the AllDle frame to hand over a session. Outside an AllDle page the calls do nothing, so this is safe to leave in your game everywhere.

const alldle = new AllDle({ gameSlug: 'your-game-slug' });
await alldle.connect();

// when the player finishes a round
await alldle.completeMode('classic', {
  won: true,
  attempts: 3,
  maxAttempts: 6,
  resultGrid: '🟩🟨⬜\n🟩🟩🟩'
});

The completion payload

Only won is required. Everything else is optional, and sending nothing but won is a perfectly good integration.

won boolean required
Whether the player solved it.
attempts number
How many tries they used.
maxAttempts number
How many your game allows, so AllDle can show "3/6" rather than "3".
score number
Your own score, if you keep one. AllDle stores it without interpreting it.
resultGrid string
Your emoji block, exactly as your players already share it. Send the grid; the caption line is dropped, because AllDle writes that line itself. Emoji, digits, spaces and basic separators only — at most 12 rows and 400 characters.
durationMs number
How long they took, if you measure it.
puzzleId string
Your identifier for the day, e.g. "1172".

Ask what is already done today

Useful for showing your own "come back tomorrow" state without keeping your own record of it.

const status = await alldle.getDailyStatus();
if (status.modes.classic?.completed) {
  showComeBackTomorrow();
}

What you get for it

  • Your game appears in players’ daily lineup, and finishing it ticks off there automatically.
  • Completions count toward the cross-game streak, which is the reason people come back.
  • Results feed the shareable Daily Card — your grid, above AllDle’s summary, with a link back.
  • Real play and completion figures in your creator dashboard rather than clicks.

Not listed yet?

The SDK only does anything once your game has a page on AllDle. Listing is free and takes a URL.

List your game