A simple TypeScript template for PlayCanvas that can also sync with your playcanvas.com project

Quick start

This template uses the playcanvas-sync tool to push files to your PlayCanvas project and requires a little bit of setup with .pcconfig and pcconfig.json.

1. Copy .pcconfig to your home directory (Mac: /Users/<username>, Windows: C:/User/<username>). .pcconfig has been preconfigured to look for a config file in the current working directory which will be this project's folder (more information here).
2. Make a copy of pcconfig.template.json and rename to pcconfig.json. This is needed to configure playcanvas-sync to upload the file to correct PlayCanvas Editor project.
3. Complete/Update the following properties in pcconfig.json using these instructions:
   • PLAYCANVAS_API_KEY - Instructions to create an API key
   • PLAYCANVAS_PROJECT_ID - Where to find the project ID
   • PLAYCANVAS_BRANCH_ID Where to find the branch ID
4. On the command line, run npm install to install the packages.
5. On the command line, run the npm script npm run watch-push.
6. This will watch the src folder for changes, compile into build/main.bundle.js and if successful, upload to your playcanvas.com project.

Please note, if you are adding new pc.ScriptTypes or attributes to existing ones, you will need to manually parse the script after upload in the PlayCanvas Editor. Please read this for more details.

npm scripts

Command	Description
npm run build	Compiles tsc files and builds to build/main.bundle.js
npm run watch	Compiles tsc files on code changes and builds to build/main.bundle.js
npm run push	Uploads build/main.bundle.js to playcanvas.com project
npm run build-push	Performs build and push npm scripts
npm run watch-push	Performs watch and push npm scripts