Running in localhost

Before running for the first time, generate a certificate and a key with the script borrowed from here.

On Linux, Mac and Git Bash for Windows

$ bash ss_certgen.sh

On Cygwin for Windows

$ bash -o igncr ss_certgen.sh

To install dependencies:

$ npm install

Before running the server, set the environment variable STAMPERY_TOKEN that you can acquire from https://api-dashboard.stampery.com/.

To start the server:

$ npm start

Open Web browser https://localhost:8443/ and make the certificate trusted.

To test that the REST API is accessible and working, you can issue a request to the ping endpoint and expect a hash to be returned:

$ curl https://localhost:8443/api/ping
6180DAB92AB0107FF5FBF55950AEB2A1F2CFFA287A213834CA7087F2276E017AD1774E4BC99A1FEFCEADF3B5507030730BFA92EAEFAD49FC4C3683AE6E182614

Deployment

Run the gulp dist task and provide the URL behind which you are deploying, for example:

$ gulp dist --url https://stampery-web-app.azurewebsites.net/

Above command rewrites the manifest to point to the correct resources.

The result is a dist folder that you can push to your hosting environment, for example:

$ cd dist
# Below in case you want to build the dependencies locally
$ npm install --production
$ git init .
$ git add *
$ git commit -m "Deployment"
$ git push https://stampery-web-app.scm.azurewebsites.net:443/stampery-web-app.git master