stamp-web-aurelia is the web front-end for managing collections of stamps and leverages the REST interfaces of stamp-web-services.
Note This project will require a stamp-web-services REST backend to correctly function. See Below for details.
Stamp Screen Shots
Browsing by a country
Creating a new stamp form
A demo server has been provided using the following credentials:
- username: demo
- password: demo
- address: http://drake-server.ddns.net:9008/stamp-aurelia/index.html
Running The App
To run the app, follow these steps.
Ensure that NodeJS is installed. This provides the platform on which the build tooling runs.
Ensure that Gulp and Aurelia CLI is installed globally. If you need to install it, use the following commands:
npm install -g gulp
npm install -g aurelia-cli
- Install the client-side dependencies with npm:
- To run the app, execute the following command:
au run --watch
- Browse to localhost:9000 to see the app. You can make changes in the code found under
srcand the browser should auto-refresh itself as you save files.
This project is only going to support the latest browsers (Chrome/Firefox/IE11/Edge) and therefore polyfills for MutationObserver and support for IE9/IE10 is being dropped.
Connecting to Webservices in Development
The REST Web Services are available from stamp-webservices. This project has detailed instructions on how to setup the environment and setup. You will need MySQL and NodeJS to do so.
Stamp-Web now includes a reverse proxy in the server (also called from watch) that will automatically proxy calls to the stamp-webservices, meaning that nginx is no longer needed.
You can access both the web-services and the application server through port 9000 (http://localhost:9000/#)
Accessing the Demo Services
Another way to access the web-services is using the reverse proxy to the demo system located at http://drake-server.ddns.net:9008/stamp-webservices. You can change this setting via "stamp-webservices" variable in the file aurelia_project/tasks/proxy.json
If you take this later approach, please note that the performance will not be great since you will be reverse proxying to a remote data service. Also note, this is a demo machine so I would appreciate it if you didn't completely corrupt the data (this is not my production data, but if I have to continually manage the system due to misuse I will close it down to outside connections)
Running The Unit Tests
To run the unit tests, first ensure that you have followed the steps above in order to install all dependencies and successfully build the library. Once you have done that, proceed with these additional steps:
- You can now run the tests with this command:
Running the Integration Tests
Webdriver for NodeJS is used for the integration tests. To run these tests execute:
mocha --timeout=8000 manage-test.js
from the selenium folder under test