Local Development builds

Local development with the builder. Use the special service build locally to develop the applications. With this you can use local IDE and run the application locally. Also use git repository on the files for easier development and version control.

The build here is closer to WASM/Service builds than the regular server build.

Some known functionality differences:

  • Not possible to run query templates against query api
  • Not possible to use server AI features
Warning

Note that this is an experimental version at the moment so there are some limitations and issues that may arise. Please report any issues you find.

Configuration

The file contains a configuration.json file where you can set up the configuration for the local development build.

The application structure used is the same as the export packages from the server.

If the application uses assets or modules (v2) then these should also be exported and put into the extra_directories field in the configuration file. This is needed for the builder to be able to include these in the build.

  "app_configuration": {
    "defaultClientCode": "100000",
    "apiMode": "",
    "cartMode": "",
    "isCartBackupEnabled": false,
    "autoSyncInterval": 3600,
    "apiCallAttemptCount": 1,
    "apiRetryWait": 2
  },
  "app_directory": "replace-with-your-app-directory",
  "automat_api_endpoint": "https://template-engine-eu10.erply.com/api",
  "clientCode": "",
  "enable_live_reload": true,
  "extra_directories": [],
  "port": 8080,
  "sessionKey": ""
}

Command line helpers

Version 1.54.2

Run the local development server with the following command:

./automat serve

Create a new template stub First paremeter is the name of the template, second is the type (page, partial, layout etc)

./automat create-template my-new page

Package the application into a zip file for upload to the server (does not upload).

./automat package

Package and upload the application to the server. This will use the session key from the configuration file to upload the application to the server.

./automat package-and-upload

Switch active directory to another application directory. Can be used instead of manually adjusting the app_directory field in the configuration file.

./automat switch my-other-app-directory

Binaries

Available local development binary packages by version:

Version macOS Linux Windows
1.54.2 automat-darwin-amd-64-1.54.2.zip
automat-darwin-arm-64-1.54.2.zip
automat-linux-amd-64-1.54.2.zip automat-windows-amd-64-1.54.2.zip