How to write Stories

A guide on how to develop applications in Storyscript.

  1. Define goals.
  2. Write stories.
  3. Build services.
  4. Deploy to Asyncy.

Define goals.

The “napkin hack” provides an opportunity to define goals and features of the application without going into the details.

Focus on high level concepts first, then list actions that drive those concepts. For example, part of your application may be to upload images from users. Here is what your goals may be:

The actions above are the story behind the goal. Now, let’s write this story in Storyscript.

Write Stories.

Below we have a Storyscript that expresses the actions of your goal in an executable program. 

Asyncy provides devtools to help write your story with autocomplete, syntax-highlighting, and more. These tools drastically improve development time and assist with service discovery. To get setup: install the Atom IDE, then install the Asyncy Atom Plugin.

Watch the video below on how the Asyncy Atom Plugin helped write this story.

Build Services.

This particular example doesn’t have any services to build. In fact, all the services used above exist in the Asyncy Hub, ready to use out-of-the-box. If your story required some unique service or function that does not exist in the Asyncy Hub, you may build the service yourself in any programming language.

Read our documentation on how to build your own services for Asyncy here:


When you are ready to deploy commit the changes to your git-backed project and deploy to Asyncy with the Asyncy CLI.

Your application is now running in a production environment! Follow the instructions in the deploy command to configure and use your application.