Web & HTML5 SDK

Error tracking for Web Games

A single script tag for any HTML5 or web game. Crash reports, player feedback, and session data — all in one dashboard.

Sign up for free
<script src="https://bugnet.io/sdks/web/bugnet-sdk.js"></script>
<script>
// Initialize
Bugnet.init({
  apiKey: "YOUR_API_KEY",
  serverUrl: "https://api.bugnet.io",
  gameVersion: "1.0.0"
});

// Show the bug report widget (e.g. on button click)
document.getElementById("report-btn")
  .addEventListener("click", () => {
    Bugnet.showWidget();
  });

// Or report programmatically
Bugnet.reportBug("Bug title", "Description", {
  category: "gameplay",
  priority: "high",
  includeScreenshot: true,
  canvas: document.querySelector("canvas")
});

// Errors are captured automatically!
// Session tracking is built-in.
</script>

Everything you need to ship bug-free web games

One Script Tag

Add a single <script> tag. Works with any framework, canvas renderer, or vanilla JS.

Automatic Error Capture

Unhandled exceptions and promise rejections are captured automatically, with recent console output attached.

Screenshot Capture

Captures your game canvas and attaches it to the report.

Session Replay

A rolling video of your game canvas, up to two minutes, attached to the report (Studio Plus).

Built-in Report Widget

A ready-made report form players can open from a button or hotkey, with no UI to build.

Tiny Footprint

About 14 KB gzipped with no dependencies. Reports are sent in the background.

Three steps to fewer bugs

1

Add the script

Drop one script tag into your HTML. Configure your project key and you're live in under a minute.

2

Players report bugs

Players tap a button or trigger a report automatically. Screenshots, errors, and session data are captured instantly.

3

You fix and ship

Triage reports in your Bugnet dashboard, assign priorities, and track fixes on a public bug tracker your players can follow.

“As a solo dev, players were leaving faster than I could read Discord. Bugnet showed me exactly which bugs were causing the most churn. I fixed the top three and my retention rate doubled in two weeks.”

SB
Sam Bell
Solo Dev, Echoes of the Rift
340+Studios
1.2M+Bug reports
38%Less churn

Choosing an engine for the web? Compare your options in Best game engines for indie developers, or read up on the two most popular browser-friendly engines: Construct 3 and Godot.

Web & HTML5 bug reporting questions

Which web game frameworks does Bugnet support?

Any of them. The JavaScript SDK has no framework dependency, so it works with Phaser, PixiJS, Three.js, Babylon.js or a plain canvas. Load it from a script tag or download the module into your project.

Does it catch uncaught errors and promise rejections?

Yes. Once initialised it records uncaught errors and unhandled promise rejections with the stack trace, browser and OS, screen size and your game version, and groups identical errors so you see how many players each one affects.

Can players file a bug from inside the game?

Yes. The SDK includes a report overlay that attaches a screenshot of your canvas, and you can open it from a key, a menu button or your own UI. Reports can carry custom metadata and file attachments.

Does it work on itch.io, Newgrounds and other hosts?

Yes. Reports are sent with standard HTTPS requests from the player's browser, so the game can be hosted anywhere, including inside the iframe that game portals use.

Is Bugnet free for Web & HTML5 games?

The free plan includes up to 100 bug reports in total (a lifetime cap, not a monthly allowance), which is plenty to integrate the SDK and run a playtest. Paid plans raise the limits and add features such as session replay.

Start tracking errors in your web game

Set up in under a minute. Free for indie projects. No credit card required.