Learning The Docs

How It's Organized

Having started your journey and having an overview of Babylon.js, the documentation is designed to take you step by step further on the journey of mastering all that this platform has to offer. The information is organized into an overview and 9 main sections, which contain chapters, together with a detailed API section, and search facilities.

  1. Babylon.js Features - Babylon.js is a fully featured game and rendering engine with a wide range of features. This section takes you through these features and helps you to, code and build with them.
  2. Adding Babylon.js to Your Web Project - There are a variety of ways to use Babylon.js in your web application and get a Babylon.js project set up. This section will help you to understand the possibilities and provides you with some templates and support for doing so.
  3. Playground - A detailed look at the central Babylon.js resource, how to use it and the many facilities it has to offer, including the ability to search all the playgrounds for examples of what others have done.
  4. Tools And Resources - Babylon.js has many incredible tools to make the development process simple and enjoyable. It also has several libraries of content available for you to use completely for free. This section will help you understand and leverage both.
  5. Preparing Assets for Babylon.js - From models and animations, to textures, LUTS, and HDR images, in this section learn the workflows and methods to prepare content for Babylon.js.
  6. Babylon.js Cross-Platform - In this section you'll learn how to extend Babylon.js beyond the web and use it to develop native applications for just about any platform you can imagine.
  7. Contribute - For those of you who want to expand the boundaries of Babylon.js this section describes what is needed and how to contribute to both the code base of Babylon.js and its documentation.
  8. Guided Learning - Sometimes it's best to learn while doing. This section helps you do just that. These step by step articles and tutorials will help you learn from some of the community's best and brightest teachers.
  9. Community Extensions - In this section you'll find incredible resources and extensions to Babylon.js, built by the incredibly talented and passionate community.

How To Use The Documentation

Babylon.js is a rich API designed to make it as easy as possible to leverage the power of the GPU for your web experience. You can leverage this powerful API by writing Babylon.js scene code in either javascript or typescript. For the purposes of consistency and maximizing accessibility of the documentation, all example code found in these pages will be provided in javascript.

The documentation page layout has several features that you'll want to know about in order to get the most out of your learning journey.

To start, the left most panel is the navigation pane. This pane is how you navigate to where you'd like to go.

Navigation Pane

Next is the content pane. It's in the middle, and you guessed it, it contains the main content and information.

Content Pane

Some pages have a lot of information that's organized into sub sections. The table of contents pane makes it easy to navigate lengthier pages.

Table of Contents

The panel on the right is the examples pane. It provides quick access to every playground (live examples) on the current page.

Examples Pane

Lastly, if you select any one of the examples in the examples pane, it will load that example inside of the playground pane at the top of the page content.

Examples Pane

A note on versioning

The Babylon.js Documentation is written with the latest major version of Babylon.js in mind. The API docs are generated against the latest nightly build.

If you want to install Babylon.js locally using the latest version, please pick the latest release from the npm page, and then run:

npm i @babylonjs/core@preview

Don't be scared about using the latest version. Babylon's npm releases are considered stable and are fully tested by the team.

The Babylon.js Forum

Next up is to learn about The Babylon.js Forum, the place where the community and dev team dive in every day to help each other learn and advance this wonderful platform.