Instant Games

Build Your Instant Game

Updated: Jun 28, 2026
Copy for LLM
Welcome to the Build section of the Facebook Instant Games documentation. This section covers everything you need to know about the technical aspects of developing an Instant Game, from writing your first line of code to optimizing your game’s performance.
Instant Games are lightweight HTML5 games that people can play directly within the Facebook app, Messenger, and on facebook.com -- no app store download required. Because they run in a web environment, you can use any technology that outputs standard HTML5, JavaScript, and CSS.

In this section

Get up and running with your first Instant Game in minutes. This Quick start guide walks you through creating a simple game from scratch, integrating the FBInstant (Facebook Instant Games) SDK, uploading your game bundle, and testing it on Facebook. If you are new to Instant Games, start here.
Instant Games work with any game engine that can export to HTML5. This page covers the most commonly used engines -- including Construct, Cocos Creator, PlayCanvas, Phaser, PixiJS, Unity, Defold, GameMaker, and Godot -- with guidance on how to export each one for the Instant Games platform.
Performance is critical for Instant Games. Many of your players will be on mobile devices with limited hardware and network connectivity. This Game performance guide covers bundle size optimization, asset compression, lazy loading strategies, JavaScript performance, frame rate targets, memory management, and testing on low-end devices.
Detailed API reference documentation for the FBInstant SDK, including all available methods, events, and data types.

Key concepts

Before diving in, here are a few important things to know about Instant Games:
  • Web-based: Instant Games run inside a WebView (on mobile) or an iframe (on desktop). Your game is standard HTML5.
  • Bundle delivery: You upload your game as a zip file (or host it externally). Facebook serves your game to players.
  • SDK integration: The FBInstant SDK provides access to player identity, social features, leaderboards, ads, in-app purchases, and more.
  • Bundle size: Your initial bundle should be under 5 MB for fast load times. Total assets can be up to 200 MB using progressive loading.
  • Cross-platform: Your game runs on Android, iOS, and desktop web. Test on all platforms.

Getting help

If you run into issues while building your Instant Game, the following resources are available: