Posts in Category "Mosaic"

My First Mosaic Application

Adobe LiveCycle Mosaic is a recent addition to the LiveCycle family that offers some interesting possibilities in the enterprise. As many of us experience when developing large enterprise applications we need to start thinking about modularization for performance or to segment the application to allow development teams to work on independent areas.

To get an application in to production for the first time requires a lot of resources, especially if compliance is required, for example FDA software validation. However, we rarely stop once the application go-lives. We want to release new features and modules, but we don’t want to re-test the whole application. There is a new version of the Flex SDK that we want to use, but we don’t want to migrate the entire codebase. So we think about using the Marshall Plan.

We are dealing with a lot of complexity and big architectural decisions. Mosaic helps to remove the complexity by providing an application framework for building and deploying composite applications. It also provides tooling for Flash Builder to improve developer productivity.

What follows is three steps to walk you through building your first Mosaic application. From there you can explore Mosaic in more depth so you can start using it as part of your enterprise architecture for building scalable and extensible Rich Internet Applications (RIAs).


  • Flash Builder 4 (I recommend using the Eclipse plugins with Eclipse for Java EE Developers)
  • Apache Ant

Step 1: Getting Mosaic running

  • Download the Mosaic trial
  • Extract the Mosaic download (if not auto extracted)
  • Open a command prompt and change directory to where you extracted Mosaic (<MOSAIC_HOME>)
  • Change directory to <MOSAIC_HOME>/standalone
  • Create a logs directory (e.g. mkdir logs)
  • Change directory to <MOSAIC_HOME>/standalone/bin
  • Run / startup.bat (if running Mac OS X or Linux you may need to change the permissions on your files – chmod 755 *.sh)
  • Start a browser and open http://localhost:8080/mosaic/about, when promoted to log in enter designer/password
  • If you see the Adobe copyright and Mosaic version then Mosaic is running!

Step 2: Install and run the samples

  • At the command prompt change directory to <MOSAIC_HOME>/samples
  • Run ant (enter ant at the command line)
  • Ant should run for ~9 seconds and you should see BUILD SUCCESSFUL
  • In your browser open http://localhost:8080/mosaic/#/applications/Basic
  • You should see your first Mosaic application
  • Now try the AIR client, run <MOSAIC_HOME>/bin/release/Mosaic.air
  • Take the time to explore the other samples, the table at the bottom of this page has all the URLs

Step 3: Build your first Mosaic application

  • Download the Mosaic ES2 plugin for Flash Builder 4
  • Start Flash Builder (Eclipse)
  • Go to Help > Install New Software…
  • Press the Add… button
  • Enter a name e.g. Mosaic
  • Press the Local… button and select the folder containing your Mosaic plugin folder (assuming your download was auto extracted)

  • Press the OK button
  • Check Adobe LiveCycle RIA Tooling

  • Press the Next button and follow the wizard to install the plugin
  • Create a new Flex Application (File > New > Flex Project)
  • Create a new MXML Tile (File > New > MXML Tile)

  • Press the Finish button
  • When prompted to Confirm Project Changes press the Yes button

  • Update your tile to show the obligatory Hello World:

  • Open the Run Configurations (Run > Run Configurations…)
  • Select Mosaic Launcher
  • Press the New button
  • Make sure your Project and Tile are selected

  • You should now see your first Mosaic application!
  • You will find more details of using the plugin and debugging here

Additional Resources