Binary Grid | Reddit for Developers

Readme

Binary Grid

Daily 6×6 binary puzzle for Reddit/Devvit.

Development

Use Node.js v24.18.0 or newer in the v24 release line and Bun v1.4.3. Install dependencies with bun install and start Reddit playtesting with bun run dev.

Run bun run test, bun run type-check, bun run check, and bun run build before shipping changes. The project compiler is TypeScript 7.0.2, installed under the @typescript/native alias; TypeScript 6.0.3 is also required by Svelte's checker. The type-check script selects TypeScript 7 explicitly to avoid the two versions' overlapping executable names.

Keep the direct Devvit packages, including @devvit/analytics, pinned to the same version (currently 0.15.0). See the Devvit changelog and 0.15.0 release announcement when upgrading.

Rules

  • Each row/col has exactly three 0s and three 1s
  • No three consecutive identical digits
  • Respect fixed clues

Analytics release and review notes

The current recovery trial, frozen settings, stop rules and prepared community materials are in RECOVERY_PLAN.md. The new moderator-only recovery menu and /api/recovery-metrics compare complete periods using daily unique solvers across posts; they become available after this change is deployed. The existing 0.12.11 production release already supports bounded catch-up dates.

Challenge sharing is disabled by default (challengeSharePercent: 0), and the evening catch-up experiment is disabled with blank start/end dates. Native share delivery remains unverified; do not enable it in production until it passes. Existing installation settings override defaults and must be checked before an upgrade.

The Journeys map for platform review is:

Event Trigger
App.Ready A puzzle successfully loads and becomes interactive
Journey.Start First committed editable-cell move or applied hint
Journey.Progress First crossing of 25%, 50%, and 75% editable-cell fill
Journey.Interaction Committed hint, undo, difficulty change, native share request, or posted score comment
Journey.End Complete rule-valid grid; incomplete when a started round is replaced or on best-effort exit

Progress measures fill, not correctness. Completion includes elapsed seconds as the score and is separate from a server-validated saved solve. Custom metadata contains only fixed action names and difficulty, never usernames, user IDs, free text or solutions. Telemetry failure does not block gameplay or saving. Native share interactions cannot occur while sharing is disabled.

Guest play, signed-in saving, leaderboard retrieval and the moderator growth readout were checked on the actual Reddit web test install. The October 28 live installation page confirmed production 0.12.11, upgraded October 26; the supplied Journeys export contains October 26–27. Native iOS/Android checks remain pending. Publishing submits a version for review; verify approval and installation separately. See the recovery plan for the latest production activation record.

About this app