This post was originally published at Tutorial Treasury: Composer

This week we’ll look back at some Composer tutorials and resources. Composer is Corona’s official scene management library, allowing you to build multiple scenes or screens into your apps and move among them at proper points in the design flow.

NOTE: In an upcoming daily build, we will be removing Storyboard from the Corona core. That will leave Composer as the one official scene manager. If you still depend on Storyboard, you should download the Storyboard module from our Github repository, place the storyboard.lua file in the core project folder alongside main.lua, and require() it under the storyboard namespace throughout your project. Of course, we highly recommend that you convert to Composer, and if you need assistance on this task, please read our Composer Migration Guide.

The Composer Library guide

The single best starting point is the Composer Library guide. This inclusive guide covers core scene setup, scene events which manage the scene’s state, API calls to change scenes, and just about everything in between.

Video tutorials

These two videos cover the essentials of Composer:


Introducing the Composer API

This tutorial introduced the Composer scene management APIs and how they work. Here you will learn the basics of constructing a scene and when things happen.

Understanding the Composer API

Composer can be used to build many different kinds of apps and games. This tutorial covers workflows for both games and “tab bar” style apps, and it covers which types of activities may be done in each scene event.

Controlling Composer scene transitions

Composer provides you with several built-in ways to transition scenes, including simple fades, cross-fades, sliding scenes in/out, and more. However, for developers who want even more options, this tutorial outlines how to create your own scene transitions and make them compatible with Composer.

Scope for beginners

While not specific to Composer, Lua scope is a fundamental aspect of development and it’s essential to understand when working with Composer. This tutorial will get you up to speed.

Further reading

Sample code


The Composer library is a very powerful tool which can give your app multi-scene capabilities, but you need to understand exactly how it works before you begin using it. These resources will get you started on that path.


This post was originally published at Tutorial Treasury: Composer