As a frontend project, KilledByAPixel/LittleJS has picked up 4.4k stars on GitHub (JavaScript). Tiny fast 2D/3D HTML5 game engine with many features and no dependencies.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
LittleJS is a fast, lightweight, and fully open source HTML5 game engine designed for simplicity and performance.
Its small footprint is packed with a comprehensive feature set including 2D and 3D rendering, physics, particles, sound, and input handling.
The code is very clean and well documented with many examples to get you started quickly.
New here? Open the example browser and change the code of any example while it runs, or jump to Quick Start and have a game on screen in a minute.
Blazing fast WebGL2 + Canvas2D hybrid rendering system
Apply Shadertoy style shaders for post-processing effects, or on any object or draw, with values the game sets each frame
2D lights with soft shadows, tinted glass and emissive objects, a sun with long shadows, spotlight cones and gels, and normal maps
Robust particle effect system with a library of ready made effects and an effect design tool
Parallax background layers that repeat across a level of any size
Follow cameras with smoothing, a dead zone, look ahead and level bounds, and camera shake
Your own icons inline in text, like a coin beside the score, written by name
Load sprites and animations into texture sheets at runtime, or import TexturePacker and Aseprite atlases
🧊 LittleJS 3D
Built-in 3D renderer that shares the canvas with your 2D game
3D objects with the same physics, children and timers as 2D
Shape builders, extruded sprites and text, and OBJ and glTF model loading
Height map terrain, voxel maps and mesh colliders, with collision and raycasts
3D levels and prefabs, built in the 3D level editor and loaded with one call
Shadow maps, colored lights, spotlights, lens flares, specular, emissive glow and fog
Reflections of a sky box or the scene itself, from mirror sharp to rough
Particles, trails, lit billboards and instanced drawing of thousands of meshes
Orbit, chase and first person cameras with mouse picking
Custom shaders on any object, with vertex code, uniforms and data for each instance
Optional Three.js plugin as an alternative renderer
🔊 Audio
Sound and music with mp3, ogg, or wave files
Use ZzFX sound generator to play sounds without asset files
Spatial audio with stereo panning
Audio effects plugin with filter, reverb, delay, distortion and compressor
🎮 Input
Comprehensive input handling for mouse, keyboard, gamepad, and touch
Customizable on screen gamepad designed for mobile devices
Pinch to zoom on touch screens, read the same way as the mouse wheel
💥 Physics
Robust arcade physics system with collision handling
Fast tilemap collision and raycasting, with one-way platforms that turn with their tiles
Swept bullet collision, so small fast objects never pass through a wall
Object collision that stays fast with thousands of objects
Full Box2D integration for realistic physics using Box2D v2.3.1 wasm
🧩 Game Systems
UI system with buttons, sliders, text input and nine-slice skins
Tween system with easing curves, and a scene system for titles, menus and game states
Timers, seeded random numbers, and save data that persists between visits
Grid-based A* pathfinding plugin with optional path smoothing
Medals, leaderboards and cloud saves on Newgrounds and Wavedash
🚀 Flexibility
Compatible with all modern web browsers and mobile devices
Full TypeScript and Module support with example projects for both
Vite starter template for instant dev server with hot reload
Great for size coding competitions like Js13kGames
Open Source and MIT licensed
🛠️ Developer Tools
Live example browser with a code editor and a write-up for every example
Built-in 2D and 3D level editors that edit your game while it runs, with undo, autosave and prefabs
Make the editors your own with your game's own object types, keys, buttons and tools, see the editor guide
2D levels load and save as Tiled JSON, so Tiled can edit them too
Debug overlay, debug drawing, and a tweakables panel to change your game's values while it runs
Asserts and logging in the debug build, stripped from the release builds
🤖 AI Friendly
The entire API is small and well documented so LLMs can produce high quality results
LittleJS AI Tools - Templates, examples, and prompts tuned for AI + LittleJS workflows
LittleJS GPT - Build LittleJS games right inside ChatGPT
Quick Start
Try it in the browser
The example browser runs every example beside its code. Edit the code and the example restarts with your change, and each one comes with a write-up of how it works and a few things to try. There is nothing to install.
One HTML file
Download the latest release from GitHub, or run npm install littlejsengine, then save this as index.html with the script path pointing at the engine file. It loads nothing else, so it runs straight from the file with no server. Click to set off an explosion.
<!DOCTYPE html>
<script src="node_modules/littlejsengine/dist/littlejs.js"></script>
<script>
function gameInit() {} // called once after the engine starts
function gameUpdate() // called 60 times a second for game logic
{
if (mouseWasPressed(0))
particleEffect('explosion', mousePos);
}
function gameUpdatePost() {} // called after physics, even when paused
function gameRender() {} // called before objects are drawn
function gameRenderPost() // called after objects are drawn
{
drawTextScreen('Hello World!', mainCanvasSize.scale(.5), 80);
}
engineInit(gameInit, gameUpdate, gameUpdatePost, gameRender, gameRenderPost);
</script>
Those five functions are the whole shape of a LittleJS game. From here, the Breakout tutorial builds a complete game in about 30 minutes.
Start a project
Pick the setup that suits you. All three use the same engine and the same API.
With Vite, for a dev server that reloads on save and a build that leaves out the plugins you do not use:
npx degit KilledByAPixel/LittleJS/examples/vite-starter my-game
cd my-game
npm install
npm run dev
With npm, in a project of your own. TypeScript types are included.
npm install littlejsengine
import * as LJS from 'littlejsengine';
With a script tag and no build step: clone this repository, or use Download ZIP on its GitHub page, and copy examples/starter. Every engine name is a global, as in the example above. The examples are only in the repository; the npm package and the release zip hold the engine alone.
A page that loads images or modules needs a local web server, since browsers block them from a file on disk. Vite brings its own. For the repository, serve its root, for example with npx http-server, then open http://localhost:8080/examples/starter/. The FAQ has more.
Learn
Example Browser - The best place to learn: 100+ short examples, each with its code, how it works and edits to try
Tutorial: Breakout - Learn how to make a simple game from scratch
Tutorial: Make a ski game - A tutorial by eoinmcg that shows how to make a pixel art style game
Making Awesome Games With LittleJS - A short talk about LittleJS with some tips on how to use it
LittleJS FAQ - Answers to common questions, from setup to publishing
Documentation
API Documentation - Every class, function and setting, searchable
Quick Reference Sheet - The whole API in one file, made to be read by people and by AI coding tools
Making Your Own Level Editor - How to turn the built in 2D and 3D level editors into an editor for your own game
Changelog - What changed in each release
JS13k Branch - A special branch for size coding events that builds to a 7KB zip
Examples
LittleJS comes with many examples, both for learning and to use as starter projects for new games.
Example Browser - 100+ single-file examples of individual engine features and small games, with editable source
LittleJS Arcade - Over 50 example games you can use as starter projects
Breakout - Block breaking game with post-processing effects
Puzzle Game - Match 3 puzzle game with HD rendering and high score tracking
Platformer - Platformer/shooter demo that loads level data, with the level editor set up for it
Box2D Demo - Box2D plugin demonstration and testbed
3D Example - The 3D plugin in one scene: terrain, shadows, lights, sprites, particles and bloom
3D Racing Game - Built-in 3D plugin: terrain, shadows and a chase camera in one short file
Three.js Platformer - 3D platformer with LittleJS gameplay and Three.js rendering
Particle System Designer - Particle system editor and visualizer
Builds
File
Mode
Module
Use case
littlejs.js
Debug
No
Debug mode with asserts
littlejs.release.js
Release
No
Optimized for release
littlejs.min.js
Release
No
Optimized for release and minified
littlejs.esm.js
Debug
ESM
Debug mode with asserts
littlejs.esm.min.js
Release
ESM
Optimized for release and minified
Develop with a debug build: it has the asserts that catch mistakes, the debug overlay (press Esc) and the level editors. Ship a release build, which leaves all of that out. TypeScript definitions are in littlejs.d.ts, which the npm package sets up on its own.
Every build includes the plugins. littlejs.min.js is about 165 KB gzipped, and the 3D plugins are a large part of that. A bundler like Vite leaves out the plugins a game does not use, so a small 2D game comes to about 29 KB gzipped, and a lit 3D scene to about 72 KB.
Games Made With LittleJS
Here are a few of the many amazing games created with LittleJS...
Space Huggers - Roguelike platformer shoot-em-up game with procedural levels. by KilledByAPixel
Black Cat Squadron - One button shooter based on a WW2 Navy squadron. JS13k 5th place! by repsej
L1ttl3 Paws - Cat glider with procedural art and levels for JS13K! by KilledByAPixel
How active is development on KilledByAPixel/LittleJS?
The most recent commit recorded on KilledByAPixel/LittleJS was 3 months ago, based on the GitHub push timestamp. The repository has 240 forks — one of the better signals of community interest.
How many stars does KilledByAPixel/LittleJS have?
KilledByAPixel/LittleJS has 4.4k GitHub stars — refresh the page for the live number, or check github.com/KilledByAPixel/LittleJS. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
What language is KilledByAPixel/LittleJS written in?
KilledByAPixel/LittleJS is written primarily in JavaScript. GitHub's language field is based on the largest share of bytes in the default branch.
What license does KilledByAPixel/LittleJS use?
KilledByAPixel/LittleJS is released under the MIT license. Always verify the LICENSE file directly on GitHub for the authoritative terms — license strings can be edited out of sync with a project's actual stance.
What topics is KilledByAPixel/LittleJS associated with?
Where can I see KilledByAPixel/LittleJS in action?
The project maintains a homepage at https://littlejsengine.com. The README tab on this page also usually contains screenshots and a quickstart.
Where do I read more about KilledByAPixel/LittleJS?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/KilledByAPixel/LittleJS is the definitive source.
Read full README in the tab above.
Is LittleJS worth your time?
ChatGPT, Claude and Perplexity can all read this page. Ask one of them what it makes of LittleJS.