LittleJS

LittleJS is a tiny, zero-dependency HTML5 game engine in a single JavaScript file. It uses WebGL for rendering and ships with input, audio, physics, particles, and tilemap helpers — all in a few dozen KB.

LittleJS works with any JavaScript bundler — Vite, Webpack, Rollup, esbuild, Parcel, and others. This page covers the generic setup. The example repo uses Vite.

Install dependencies

npm install littlejsengine
npm install @wvdsh/sdk-js

@wvdsh/sdk-js's default export is the live, fully-typed Wavedash SDK singleton.

Wire up Wavedash.init()

In the file where you call engineInit(...), import Wavedash and call init() inside gameInit.

import Wavedash from "@wvdsh/sdk-js";
import { engineInit, vec2, setCameraPos, setCameraScale } from 'littlejsengine';

Wavedash.updateLoadProgressZeroToOne(0.3);

function gameInit() {
  // Your game's one-time setup.
  Wavedash.init({ debug: true });
}

function gameUpdate()     { /* per-frame logic */ }
function gameUpdatePost() { /* after physics */ }
function gameRender()     { /* WebGL draw */ }
function gameRenderPost() { /* UI / overlays */ }

engineInit(gameInit, gameUpdate, gameUpdatePost, gameRender, gameRenderPost, []);

Call updateLoadProgressZeroToOne(...) during async asset loading; init() automatically signals load completion, so call it last.

wavedash.toml

Point upload_dir at your bundler's output directory. For Vite and most other bundlers that's ./dist.

game_id = "YOUR_GAME_ID_HERE"
upload_dir = "./dist"

Local development

Produce a build, then run wavedash dev to serve it through the Wavedash sandbox.

SDK features

Once initialized, Wavedash exposes leaderboards, achievements, stats, and user data:

const user = Wavedash.getUser();

const lb = await Wavedash.getLeaderboard("high-scores");
await Wavedash.uploadLeaderboardScore(lb.data.id, score, true);

Wavedash.setAchievement("first_win", true);