Build system - PhpGt/WebEngine GitHub Wiki
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.