Hackathon attendee identity system and application portal

Nucleus runs on Hack, which requires HHVM. To install HHVM, follow the instructions on their website.

All Nucleus requests route through app.php in the root of the project, with static resources being pulled from the public folder. This requires a custom Nginx rule. Here is an example:

server {
  listen 80;

  root /var/www;

  server_name nucleus.example.com;
  include hhvm.conf;

  location / {
    try_files /public/$uri /app.php$is_args$args;
  }
}

Note the include hhvm.conf;. The HHVM install should have created this file in /etc/nginx on installation. If not, these are good instructions on how to configure nginx to use HHVM.

Nucleus is backed by MySQL. The schema can be found here. TODO: Add more instructions about MySQL setup.

Nucleus uses Composer to manage dependencies. Once Nucleus is downloaded, run composer install in the root of the project.

Nucleus uses Robo as a task runner and build tool. This should have been installed with the rest of the dependencies from Composer. To generate the URI map, which is required for Nucleus to run, run ./vendor/bin/robo build (or just robo build if you have it installed globally). Creating a controller or updating a controller's path will require a re-build.