No description, website, or topics provided.
Switch branches/tags
Nothing to show
Clone or download
madarasz madarasz
Latest commit 906f76d Sep 21, 2018
Permalink
Failed to load latest commit information.
app
bootstrap
config
database
public
resources
storage
tests
vendor/lusitanian/oauth/src/OAuth/OAuth2/Service
.example.env
.gitattributes
.gitignore
abr.conf
artisan
composer.json
composer.lock
get_id_images.sh
gulpfile.js
package.json
phpunit.xml
readme.md
server.php
update_site.sh

readme.md

AlwaysBeRunning.net (ABR)

Installation (Linux/Mac)

You will need the following in order to run ABR locally:

  • MySQL (preferably)
  • PHP
  • PHP Composer
  • Node, NPM
  • JQ - download via apt-get (Debian) or homebrew (Mac), this is NOT an npm module
  • imagemagick
  1. Clone ABR from GitHub

  2. Install npm dependencies, install npm gulp globally

     npm install
     npm install -g gulp
    
  3. Install PHP dependencies

     php composer.phar install
    
  4. Run gulp to prepare assets (do this every time if you change JS or CSS)

     gulp
    
  5. Configure the settings of your local environment. Rename the .example.env file to .env. Edit the DB settings to connect to your locally running DB. Ask the main dev (madarasz / Necro) for NetrunnerDB keys. Google API keys, you can create yourself.

  6. Prepare ID icons by running this script (downloads from NetrunnerDB, run it regularly)

     ./get_id_images.sh
    
  7. Prepare DB tables

     php artisan migrate
     php artisan db:seed
    
  8. Run the webapp. It should be available at http://localhost:8000 afterwards.

     php artisan serve
    
  9. Make yourself an admin. Go to the webapp in your browser. Login via NetrunnerDB to enter your user in the DB. Check your DB (use phpMyAdmin), in table users set the admin value of your user to 1. If you reload the webapp you should see the Admin section in the top menu.

  10. Download all the data required from NetrunnerDB. Go to Admin section and click the Update Card cycles, Update Card packs and Update Identities buttons to get the data. Do this every time a new pack comes out.

  11. You are done :)

Automated tests

There are Nightwatch automated integration tests in the tests/nightwatch directory.

Run Nightwatch tests on Chrome by command:

    gulp nightwatch:chrome

There are currently problems with running tests on PhantomJS and Safari Safari browser must be enabled for automation, [https://webkit.org/blog/6900/webdriver-support-in-safari-10/](read more)