Build system

The Build repository is separately maintained at https://github.com/PhpGt/Build

WebEngine's responsibility is purely within your application's server-side PHP code, but it plays well with client-side technologies such as EcmaScript and Sass.

As standard, WebEngine comes with the gt build command, as described in the gt commands section, which provides a system for defining and running client-side build processes automatically, using tools already installed by your favourite client-side dependency manager.

However, if you prefer to use a particular build system, you can do without affecting WebEngine at all.

What does the build system do?

The PHP.Gt/Build system is only concerned with executing pre-defined build commands on client-side files, and does not aim to manage client-side tooling dependencies. The idea is that as a developer you can handle that yourself, or use an already understood client-side dependency manager to handle this for you.

// Runs in a separate process to WebEngine

// Can be run with --watch flag to execute every time a file changes, which is useful for local development.

Configuration with build.json

// Layout of the json file

// Source file patterns to check -> command to run

// Default provided for you by WebEngine

// Allows the use of existing tooling setups with minimal configuration.

Default capabilities

// ES6 compilation

// Sass compilation

// Asset syncing

Adding new capabilities

// TODO: Add example of HAML->HTML or something like that.