Passport-Live

This is the next version of Passport; rebuilt in NodeJS Passport Live is a modern web app for schools that helps them manage passes.

NOTE

Raven and Sentry.io are included if you install the optional deps. See docs for more info

Installation

NOTE: These instructions are assuming you are using Ubuntu 16.04+ LTS

1. Install the latest version of NodeJS Here
   a. Be sure that NPM was also installed.
2. Install rethinkdb by following this tutorial.
3. Give your user account ownership of npm. This is so you don't need sudo.
   a. First Try: ~$ sudo chown -R $(whoami) ~/.npm
   b. If that dosn't work, try: sudo chown -R $(whoami) /usr/local/lib/node_modules
4. Download the latest version of "Passport-Live", ~$ mv it to your desiered location
5. ~$ cd into its containing folder and then Unzip it.
6. Run ~$ npm install
   a. (NOTE.) If you get errors related to "node-sass", run rm -rf node_modules and then run ~$ npm install --unsafe-perm
7. Run ~$ rethinkdb
8. Run in a new termanal instance ~$ npm run configure:db
9. Once that is done, run ~$ npm run configure:root to create an admin permission key to create an account.
10. CTRL^C Exits the program.

Updating

We HIGHLY recommend that you use git for updating the code, however please be sure that there are no breaking changes documented or you may have to change any coustom code.

If you are using git:
Before you update for the first time, please run ~$ git update-index --skip-worktree config/local.json && git update-index --skip-worktree config/default.json && git update-index --skip-worktree config.js

To update, run git pull

Usage

To start the server, run ~$ npm run db THEN ~$ npm start from within the folder "package.json" is located.
Tmux may be useful for servers.

Special Thanks

Thanks to CrossBrowserTesting we are able to ensure that Passport works, not only on Chrome, but on many popular mobile devices and browsers. CBT helps us to cut down on UI testing and focus on adding new features.

Docs

github.io docs

This is a work in progress.

Logos

Found here or if you want a link for your site, you can use: https://cdn.josephhassell.com/passport/logo/main/[SIZE]x[SIZE].png
For just the anchor, use https://cdn.josephhassell.com/passport/logos/anchor.svg