Learning The Docs

How It's Organized

The Babylon.js documentation is designed to take you on a step by step journey of mastering all that this platform has to offer. The information is organized into 7 main sections, each one expanding on the knowledge from the previous.

  1. Getting Started - This section is designed to take you on a step by step journey of scratching the surface of Babylon.js and everything it has to offer.
  2. Diving Deeper - Organized by feature, this section will help you take the next step, expand on your knowledge of the platform, and give you a solid understanding of the depth of possibilties in the engine.
  3. Advanced Topics - This section will transform you into a Babylon.js expert. Tackling the most dense and advanced topics, this section is not for the faint of heart.
  4. Tools And Resources - Babylon.js features 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. 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 communities best and brightest teachers.
  6. Extensions - Bayblon.js is completely free and open source and has one of the world's most amazing development communities behind it, pushing it to be the best that it can be. This section contains information about some of the incredible technology built by the community to that will extend your Babylon.js development even further.
  7. API - For the most seasoned Babylon.js developers, those who want to understand every single possible super power available, the API meticulously documents every corner of this fantastic platform.

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.

Getting Started

The best place to get started is...well you guessed it, right at our Getting Started section. If you're the type of learner that does better exploring on your own, then the Diving Deeper section is for you. If you are already in love with Babylon.js and want to start contributing to its success, then the Develop With Babylon.js section is the place for you.

Well, that's it. Hopefully that's enough to get you started. Oh, and as we like to say, welcome to the Babylon family. Enjoy your journey!