master build

develop build

A front end for osf.io.

You will need the following things properly installed on your computer.

• osf.io back end
• Git
• Node.js (with NPM)
• Ember CLI
• Watchman

• git clone https://github.com/CenterForOpenScience/ember-osf-web.git
• cd ember-osf-web
• yarn --frozen-lockfile

Watchman states "Only applicable on OS X 10.6 and earlier". Though it's been observed this setting can remain incorrect on systems where the operation system was upgraded from a legacy version.

Putting the following into a file named /etc/sysctl.conf on OS X will cause these values to persist across reboots:

kern.maxfiles=10485760 kern.maxfilesperproc=1048576

Configure the application for local development, add the following to your config/local.js:

module.exports = { // an ally audit can use 100% of your browsers cpu, so use it wisely A11Y_AUDIT: false, // toggle on/off the engine applications you will be working on COLLECTIONS_ENABLED: false, // sourcemaps are useful if you need to step through typescript code in the browser SOURCEMAPS_ENABLED: true, };

• ember serve
• View the ember app (alone) at localhost:4200

To integrate with the legacy front end at localhost:5000, you have two options:

• Enable the waffle flags for each page in your local OSF Admin
• Add routes to your osf.io/website/settings/local.py:

  EXTERNAL_EMBER_APPS = { 'ember_osf_web': { # ... 'routes': [ 'handbook', 'dashboard', # ... ], }, # ...

Make use of the many generators for code, try ember help generate for more details

• ember test
• ember test --server

• ember build (development)
• ember build --environment production (production)

• ember.js
• ember-cli
• Development Browser Extensions
  • ember inspector for chrome
  • ember inspector for firefox