Skip to main content

Troubleshooting

Error while uploading applet to signageOS via sos applet upload?

The error might be caused by some of these situations:

Missing .sosignore

If you do not have the .sosignore file in your project, the .gitignore is used instead. A solution to that is to add .sosignore and put there all files and folders that are not supposted to be in the final built application. Usually the only thing you do not ignore is the /dist folder.

Make sure you definitely ignore the .git folder.

Empty files

Right now, there is a bug that prevents you to use sos applet upload if your files or files in folders are completely empty. Please, check your project (usually the /dist) folder for any empty files e.g.: .gitignore, .nojekyll, etc.

sos is undefined and cannot use the JS API

In case you do not have sos object available, you need to manually add it to your project by one of the following options:

Option A

import sos from '@signageos/front-applet';

Option B

const sos = require('@signageos/front-applet');

Option C

<script src="..path/to/the/front-applet.js" />

You can manually download the library here: https://2.signageos.io/lib/front-applet/6.6.0/bundle.js.

You can also download any other version by changing the 6.6.0 to other version that is available.

tip

See the JS SDK (@signageos/front-applet) changelog: https://docs.signageos.io/hc/en-us/articles/4409188685074-Front-Applet