🎄 Christmas Wheel – Troubleshooting & Common Issues

1️⃣ Spin Button Not Working

✔ Ensure JavaScript is enabled in your browser.
✔ Reload the page (Ctrl + F5) to fix cached script issues.
✔ If you added custom JS, verify the spinWheel() function exists.
✔ Make sure there are at least 2 items in the wheel.

2️⃣ Wheel Spins but Never Stops

This usually happens when animation duration or easing is overwritten.

✔ Confirm no CSS framework overrides transform or transition.
✔ Make sure spinning uses transition: transform 5s cubic-bezier(...).
✔ Ensure the rotation angle is calculated properly.

3️⃣ Wheel Items Not Loading After Upload

✔ Ensure your uploaded .txt file uses line-by-line items.
✔ The upload button should read file → update textarea → update wheel.
✔ Check for extra blank lines in the file.
✔ Special characters should be UTF-8 encoded.

4️⃣ Confetti Not Showing After Spin

✔ Confetti library may be blocked by browser extension.
✔ Make sure the confetti JS script loads before using it.
✔ Some browsers may require a user interaction before animation can start.

5️⃣ Download / Copy Buttons Not Working

✔ Ensure buttons pull data from wheelItemsInput textarea.
✔ Grant clipboard permission if asked by browser.
✔ For Download: file must be generated via Blob → URL.createObjectURL.
✔ Avoid using outdated cached JS.

6️⃣ Some Text Not Visible on the Wheel

✔ Increase text contrast (white text on dark backgrounds).
✔ Ensure your color palette has good readability.
✔ Long names may wrap incorrectly; shorten or reduce font-size.
✔ Verify ctx.fillText settings in canvas drawing.

7️⃣ Wheel Looks Blurry on Mobile

✔ Use devicePixelRatio scaling for canvas.
✔ Ensure CSS does not force a distorted width or height.
✔ Keep padding & margins balanced for smaller screens.

8️⃣ Page Feels Slow or Laggy

✔ Too many items (100+) can slow canvas drawing.
✔ Confetti effect uses many particles; reduce count for low-end devices.
✔ Avoid loading large external libraries alongside the wheel.
✔ Keep canvas resolution optimized.

🎡 Back to Christmas Wheel