Installing Turbo

[g105b]

This should be handled automatically by WebEngine: add phpgt/turbo to your composer's requirements and WebEngine will pick it up automatically - a one-click opt in.

For other frameworks, there would be a documented method of including the file correctly.

[g105b]

Once installing using Composer, I want there to be the most minimal number of steps required by the developer to start using Turbo.

Composer will place the distribution file in vendor/phpgt/turbo/dist/turbo.js and vendor/phpgt/turbo/dist/turbo-sw.js.

All the developer needs to do then is <script src="/turbo.js" defer></script>.

The script itself can load the turbo-sw as a service worker, and the developer will be free to start adding data-turbo attributes wherever they need.

[g105b]

NPM or similar is the solution. While developing, its source can be included like this:

{
  "dependencies": {
    "@phpgt/turbo": "file:../../PhpGt/Turbo"
  }
}

and the directory within node_modules can be replaced with a symlink for rapid development.

To use the latest version from Github:

"dependencies": {
  "@phpgt/turbo": "github:phpgt/Turbo"
}

Or a specific version:

"dependencies": {
  "@phpgt/turbo": "github:phpgt/Turbo#v1.0.0"
}