Left Wordle — Testing Guide

← Back to Left Wordle

Work in Progress. Left Wordle's save/sync features are under active development. Functionality, UI, and data formats are subject to change without notice.

Cloud data is temporary. All cloud-synced data will be deleted when sync is promoted to production. Do not rely on cloud sync as your only backup.

Staging environment. Cloud sync testing takes place on staging.left-wordle.com. The staging site connects to a shared Supabase project. If something breaks, clearing your browser's localStorage for the staging site is a safe reset.

Staging environment.The Words "Left Wordle" in the header will appear in yellow on the staging site, indicating that you're on Staging. Stats and streaks Do Not Sync between staging and production. please continue to play in production daily to build your stats and keep your streak alive.

1 Import & Export (Save Menu)

Open the save menu by clicking the Save / Sync button to the immediate right of "Left Wordle" in the header.

1a. Export History

  1. Play at least one game to completion (or load sample data — see 1c).
  2. Open the save menu and click Export History (JSON). A file named wordle_history_YYYY-MM-DD.json should download.
  3. Repeat with Export History (CSV). A .csv file should download.
  4. Open each file and verify the entries match your played games. Each entry should include: puzzle_num, date, result, answer, mode, starter, completed_at, updated_at, device_id, origin.
  5. Games played in the app should have origin: "played".

1b. Import History

  1. Click Import History (CSV or JSON) in the save menu.
  2. Select a previously exported file (JSON or CSV).
  3. After import, a summary dialog should appear showing:
  4. Imported entries should have origin: "imported" when re-exported.
  5. Open the statistics modal ( Statistics button) and confirm the counts reflect the imported games.

1c. Import Test Scenarios

Scenario Expected Result
Import a valid JSON file with new games All rows added; no flags
Import a valid CSV file with new games All rows added; no flags
Import a file containing a game already in history Duplicate row flagged as "already exists in history"
Import a file with two rows for the same puzzle First row imported; second flagged as duplicate within file
Import a row missing puzzle_num, date, and answer Row flagged as missing deterministic fields
Import a row with conflicting puzzle_num and date Row flagged with conflict message
Import a row with result of "X" or "fail" Imported successfully with result normalized to 7

1d. Save & Load Statistics

  1. Click Save Stats in the save menu. A JSON file should download.
  2. Clear localStorage (DevTools → Application → Local Storage → clear the site).
  3. Reload the page and click Load Stats. Select the saved file.
  4. The page should reload and the statistics modal should show your restored data.

1e. Adjust Statistics

  1. Click Adjust Stats in the save menu.
  2. Modify a value (e.g., increase Games Played by 1).
  3. Verify the live preview updates Win % and Average Guesses correctly.
  4. Save and confirm the statistics modal reflects the change.

2 Cloud Sync

Cloud sync is available on staging.left-wordle.com. It is not yet enabled on the production site.

2a. Sign In

  1. Open the save menu on staging.left-wordle.com.
  2. Scroll to the Cloud Sync (Beta) section.
  3. Enter your email address and click Send Magic Link.
  4. Check your inbox for the magic link email and click the link.
  5. You should be redirected to a brief "Completing Sync Sign-In..." page, then back to the game.
  6. Reopen the save menu — it should now show "Signed in as [your email]".

2b. Basic Sync — Single Device

  1. Sign in on staging (see 2a).
  2. Play a game to completion.
  3. Open the save menu and click Sync Now.
  4. Clear localStorage for the staging site, then reload the page.
  5. Sign in again with the same email.
  6. Your game history and statistics should be restored from the cloud.

2c. Cross-Device Sync

  1. Sign in on Device A (or Browser A) and play a game.
  2. Click Sync Now on Device A.
  3. Sign in with the same email on Device B (or a different browser / incognito window).
  4. After sign-in, your history and stats from Device A should appear on Device B.
  5. Play a game on Device B and sync.
  6. Return to Device A, click Sync Now, and confirm the new game appears.

2d. In-Progress Game Sync

  1. Start today's puzzle on Device A (make 2-3 guesses but don't finish).
  2. Sync on Device A.
  3. Open Device B, sign in with the same email.
  4. Today's puzzle should load with the same guesses already on the board.
  5. Finish the game on Device B and sync.
  6. Return to Device A and sync — the completed game should appear.

2e. Background Sync

  1. Sign in and start a game.
  2. After each guess, changes should sync automatically in the background (within ~1 second).
  3. You can verify this by watching the browser's Network tab in DevTools for Supabase API calls after each guess.

2f. Sign Out

  1. Open the save menu while signed in.
  2. Click Sign Out.
  3. The sync section should return to the email input form.
  4. Local data should remain intact after sign-out.

3 General Testing Notes

Reporting Issues

The best way to report a bug is to email me: scott at left-wordle dot com

When reporting a bug, please include:

Resetting Your Environment

If things get into a bad state, you can reset by clearing localStorage:

  1. Open DevTools (F12 or Cmd+Option+I).
  2. Go to Application → Local Storage.
  3. Right-click the site entry and select Clear.
  4. Reload the page.