Installation - dsriseah/ursys GitHub Wiki

URSYS is used for rapid prototyping of academic Learning Science research software. It is actively developed/tested on MacOS as this is the popular hardware platform in many departments. We also primarily assume Chromium/V8-based browser for web apps, typically running on Chromebooks in the classroom. Our secondary compatibility target are iPads running IOS. The Safari and Firefox browsers on desktop are the least tested platforms.

The URSYS Build Framework is the tooling that surround URSYS feature development, and is designed to work on a local computer running MacOS or Linux from the terminal. In the future, URSYS will be available as a package that you can import into your NodeJS project without the Build Framework.

There are two basic packages you need to have installed before using the URSYS Build Framework:

• Git - For MacOS, this is done by executing the command xcode-select --install and accepting the dialogs. For Linux, see your distro's development package.
• Node Version Manager - installed via script from official repo at https://github.com/nvm-sh/nvm by following the Install & Update Script instructions in the README

To run the server, it's recommended that the host computer has a minimum of 2GB free memory for development. On Linux systems, use the free -m command to check. If you are using remote editing with Visual Studio Code, you will need a minimum of 4GB to run well.

We have standardized on Visual Studio Code (VSCODE) because it is free at the time of this writing. While VSCODE isn't required to run the Build Framework, we do make use of VSCODE extensions and .code-workspace settings to help ensure a consistent editing experience for all contributors to our codebase.

The Build Framework's target developer is an intermediate-level programmer who develops their code as they think-through their challenges, so our VSCODE build system implements "live linting", "format on save", and "hot module reloading" as much as possible. We generally do not implement CI/CD features or employ a rigorous regression testing workflow at this time.

The Live environment is dependent on configuration files that are tailored for day-to-day use, but you must open the .code-workspace project file to ensure runtime checks are working.

After ensuring that git and nvm are installed correctly, follow the instructions for your specific system:

1. From the terminal: git clone https://github.com/dsriseah/ursys.git
2. Open Visual Studio Code and open the sri-ursys workspace file.
3. Open the integrated terminal (ctrl ~), type: nvm use; npm ci
4. Run the test app with npm run example

• MacOS
• Ubuntu (on Digital Ocean)