Robi

Local Development

npm install
npm start

Deploy to SharePoint

1. Create a build of your app.

npm run build-sp min

2. Create a new site or subsite. (Note: only deploy one Robi app per site or subsite.)
3. Create a new document library named App.
4. Copy the /src directory from /dist to the App document libary (Note: include the /src directory. Don't just copy it's contents).
5. Launch App/src/Pages/app.aspx.
6. Click Install.

Troubleshooting

If you see error messages in the terminal session that's running the local development server, try these steps.

Trigger: Edit > Modify Routes

Error

EPERM: operation not permitted, watch at FSEvent.FSWatcher._handle.onchange

EPERM: operation not permitted, rename './src/Routes/OldRouteName' -> './src/Routes/NewRouteName'

Fix

Stop the server with ctrl + c and close your text editor and terminal. You'll probably need to fix broken paths since the server was in the middle of renaming files and directories. Then restart the development server.

If that doesn't work, check if there's another program using the named directory. Sometimes antivirus and file sync apps (OneDrive, iCloud Drive, Dropbox, etc.) will lock directories to changes. Pause them and try again.

npm start

Trigger: A previous server session didn't close properly or another process is using port 3000

Error

Some error occurred Error: listen EADDRINUSE: address already in use 127.0.0.1:3000
    at Server.setupListenHandle [as _listen2] (node:net:1334:16)
    at listenInCluster (node:net:1382:12)
    at GetAddrInfoReqWrap.doListen [as callback] (node:net:1520:7)
    at GetAddrInfoReqWrap.onlookup [as oncomplete] (node:dns:73:8) {
  code: 'EADDRINUSE',
  errno: -4091,

Fix

Stop the server with ctrl + c and restart.

npm start

If that doesn't work, open Task Manager and end all Node.js processes.

Trigger: CodeMirror scroll/resize is slow

Fix

Close dev tools! Oddly enough, it works.