Skip to content
No description, website, or topics provided.
Branch: refactor
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


gulp-ps-tasks is a collection of Gulp tasks that makes it easier and faster to develop PowerSchool customizations and deploy them to a PowerSchool "image" server (cdn).


1. Install dependencies:

npm install -g babel babel-cli babel-register babel-plugin-transform-es2015-modules-commonjs
npm install --save-dev gulp-ps-tasks

2. Copy .babelrc and local.gulpfile.babel.js to the root of your project folder.

3. Rename the local copy of local.gulpfile.babel.js to gulpfile.babel.js.



A config.json file is required for the following information:

  • Image server sftp credentials
  • Any URLs that should be dynamically inserted into your project's code The config.json file location can be specified one of three ways. As soon as a config file is found, the search for a config file stops and the first config file found is used. Note that the config path should only include the path to your config.json file -- it should not include the config.json filename itself. Trailing slashes don't matter, they will be removed if they're included.
  1. Command Line Option: add a --config {configPath} option to your gulp {taskname} command. Example: gulp build --config /home/nathan/projects/plugins.
  2. config.json is placed in your project folder.
  3. Set an environment variable, PSTASKS_ROOT, to the directory path of your config.json file.

If you have a large number of plugins, I recommend using method 3 because it allows you to create and maintain a single config.json file that can be used across all of your plugins. However, if you want it to just work, use method 2.


The following config example should be used as a starting point for your own config.json file.

  "image_server_name": {
    "sams_url": "",
    "api_url": "",
    "deploy_credentials": {
      "host": "sftp_host",
      "user": "user",
      "pass": "password",
      "remotePath": "/path/to/assets/folder"

  "image_server_name2": {
    "sams_url": "",
    "api_url": "",
    "deploy_credentials": {
      "host": "sftp_host",
      "user": "user",
      "pass": "password",
      "remotePath": "/path/to/assets/folder"
  // Optional: If no --env options is passed to the deploy task, 
  // provide the "image_server_name" that should be used as a default
  "default_deploy_target": "image_server_name"

Local gulpfile

In order to use the gulp tasks included here with your own project, make a copy of the local.gulpfile.babel.js file and rename it to gulpfile.babel.js.

Task Usage

Run a task using gulp {taskname}


Uses a preprocessor to insert the image server url into your project. Places the resulting files in the dist folder.


Creates a .zip file with using all of the files in the dist folder. The build task places its files in the dist folder, so this task is almost always run after running build.


Run the preprocessor on everything in your project's src folder and automatically deploy those files to your image server. Useful for making rapid development changes.

You can’t perform that action at this time.