Storyboard: Scene Purging vs. Removal

Posted by & filed under Tutorials, Tips and Demos.


One of the most confusing aspects of Corona’s storyboard API is the purging and/or removal of scenes. What’s the difference between purging and removing? What does it mean to “purge” a scene anyway? Those are just a few of the many questions we receive often.

Today, I’m going to attempt to clear up the confusion by first giving you a high-level overview of what’s going on behind-the-scenes when purging and removal goes on, and also show you a few examples along the way.

Tutorial: Using System Events to Save App State

Posted by & filed under Tutorials, Tips and Demos.


Something that’s becoming increasingly popular is the ability to “pick up where you left off” or stop and resume with hardly any friction. More and more, apps are starting off exactly how you left them—and that doesn’t exclude mobile apps (in fact, mobile is arguably what inspired this behavior).

Having your apps start off where your user left them is also known as “state saving”, and that’s exactly what I’m going to cover in this tutorial. As with any tutorial that’s posted here, I encourage you to take what you learn and build upon or modify the code to suit the specific needs of your app.

Best Practices for Organizing Projects

Posted by & filed under Tutorials, Tips and Demos.


Something that isn’t clear by studying Corona’s included SampleCode or any of the other examples and tutorials on this website is the concept of organizing projects. We’ve sort of just let you know that everything goes into your project folder and sent you off on your way—and oh, sub-folders are supported. That’s about all we’ve said on the subject up until now.

However, as your projects get bigger, that may not be quite enough. With more and more resources are being added to your project, such as audio files, images, videos, Lua modules, etc. it can add a whole new layer of complexity to the development process—complexity that isn’t at all necessary.

This tutorial is by no means the end-all to Corona SDK project organization techniques, but it will introduce you to an effective one that you can tweak at your heart’s content to suit your needs perfectly.

Properly Removing Objects and Variables

Posted by & filed under Tutorials, Tips and Demos.


Removing objects and getting rid of unneeded variables may seem trivial, but it’s actually common question among Corona newcomers and veterans alike.

The potential consequences of doing this simple-but-important task incorrectly can lead to memory leaks, app slowdowns, and even crashes (which you don’t want, obviously).

How to Use Custom Events in Corona

Posted by & filed under Tutorials, Tips and Demos.


A little over a year ago (in June of 2011), I went over the Corona Event Model, and explained exactly what events are in Corona, when they occur, and how you can “hook” into them to take advantage of some of Corona’s best features.

However, in the previous article, I kept the subject-matter focused on the built-in events associated with specific API’s that are provided out-of-the-box in Corona. What I didn’t mention is that you can define your own custom events, and have objects listen for when those events are dispatched (which you have complete control over as well).

This tutorial will walk you through defining and dispatching custom events, so you can begin applying the knowledge to your own games and apps.

Guided Tour of Corona’s API Reference

Posted by & filed under Tutorials, Tips and Demos.


This week’s tutorial is going to be a little different. Rather than go over yet another awesome Corona feature, I’ll instead be walking you through another aspect of Corona development that’s arguably just as important (if not more important) than any one specific feature of the SDK. What you’ll be learning about today is something you’ll undoubtedly use in every single Corona project you work on, and that is of course is the Corona SDK API Reference.

How to Use Bitmap Masks

Posted by & filed under Tutorials, Tips and Demos.

EDITOR’S NOTE: This tutorial is outdated and has been replaced by a new guide: Masking Images. Please refer to this guide for details and usage examples. In this week’s tutorial, I’m going to cover a feature that, while infinitely useful for many projects, you may not even be aware exists because of its specialized use-cases. That feature is bitmap masking, which is accessed from the graphics.newMask() function. You may not know what bitmap masking is, or you might not see how it could be useful to you. In either case, stick around because this is definitely a good tool to have in the “tool shed”. Bitmap masks can be used to solve some otherwise tricky problems which include (but is not limited to): Disable touches

Tutorial: Handling Corona System Events

Posted by & filed under Tutorials, Tips and Demos.

When developing applications, it’s important to handle scenarios that occur as a result of the user interacting with your game in as many different ways possible. It’s equally as important to handle scenarios that occur as a result of “system” events, whether they are explicitly triggered by the user or not. Things that immediately come to mind are things that cause your app to become “suspended” such as the user receiving a phone call, or pressing the “home” button on their device (your app is still running in the background, but in a suspended/paused state). What about when the user comes back to your app while it is suspended, or when your app exits completely? All of those things are handled by “system” events in

Tutorial: LuaFileSystem (LFS)

Posted by & filed under Tutorials, Tips and Demos.

For those who don’t know what LFS is, it’s a popular Lua library that allows you to perform common file system activities that can’t normally be done in plain Lua. Things like getting file attributes, creating and removing directories (folders), and iterating over files in a directory are all things that can be easily done using LFS. During the course of this tutorial, it might help to have a separate tab open with the LFS Reference. Directory Scanning Let’s say you were creating a note-taking app that allows users to create, save, and read text-based notes that are all saved to system.DocumentsDirectory. Sure, it’s easy to keep track of what the user does inside of your app. You could simply keep your own record of