Starter application

You can find Starter application in the Brixy/Examples folder. This is MVC application skeleton prepared for quick start of your new project.

Startup

  1. Copy the Brixy/Examples/Starter folder to your script folder.
  2. Rename your new Starter folder to the MyApp.
  3. Rename the MyApp/Starter.jsx file to the MyApp/MyApp.jsx.This is the main script file of the application.
  4. Open the MyApp/MyApp.jsx file. Correct the path for including the application launcher Brixy/includes/app-launcher.jsxinc.
  5. Open the MyApp/tests/Tester.jsx file. Correct the path for including the tester launcher Brixy/includes/tester-launcher.jsxinc.

Now run MyApp/MyApp.jsx.

Project structure

Main script file: MyApp/MyApp.jsx
This script includes and runs the application launcher. Launcher takes care about loading core Brixy libraries and config file.

Config file: MyApp/config.jsxinc
Config loads your own application modules, defines the application itself and its basic units, e.g. services, routes, events, startup route.

Application modules: MyApp/app
This folder contains your own application modules.

Model: MyApp/app/model
This folder contains all model modules.

Controllers: MyApp/app/resultCtrl, MyApp/app/startupCtrl
Each of these folders contains a controller and its views. You will replace Startup controllers with your own.

Unit tests: MyApp/tests
This folder contains test launcher Tester.jsx and folder jobs with test job files.

Development

  1. In most cases you don't need modify the main script file MyApp/MyApp.jsx, except for the correction of the path to app-launcher.jsxinc file. For persistent applications you can insert Extend Script #targetengine directive at the beginning of the file.

  2. Create application model classes and modules. Put them into MyApp/app/model folder. Model is the logic core of the application. It holds data, settings, algorithms and other logic parts of the application.

  3. Create unit tests of the model classes. These are the first use cases. Place test jobs into MyApp/tests/jobs folder. MyApp/tests/Tester.jsx script is prepared to execute all test jobs.

  4. Add new model modules as services to the MyApp/config.jsxinc file, so they can be used in the controllers.

  5. Create controllers and its views. Controller communicates with the model and initializes views. Not every controller needs a view. Use dependency injection for passing model modules to the controller. Finally, as a result of its work, controller returns a new request route.

  6. Modify MyApp/config.jsxinc file: add startup controller, add request routes if needed.

  7. Run MyApp/MyApp.jsx.

Development tools

Brixy Mixer helps with creating of new source files of all types.

Debugging can be fun with Brixy debug modules: Dump, Call stack, Timer, Summary, System info, error reporting. See Brixy/Examples/Debug tools.

Deployment

Use Brixy Linker tool to link all source files into one final independent script file.

Edited: 2016/11/17