README.md 2.2 KB

Asset formats explained


Images:

  • PNG images and external assets are stored in assets/images
  • SVG images are stored in assets/icons
  • CSS files in assets/style
  • Translations are in assets/translations


JSON file formats:

[!NOTE]
Note: If a property is wrapped with square brackets ([name]), it means that the property is optional


locales.json

This file contains a definition of the available locales and translations.
The keys of the object are the locale codes, and the values are the locale objects, with the following properties:

Property Type Description
name string The name of the locale in the locale's language
nameEnglish string The name of the locale in English
emoji string The flag emoji of the locale
userscriptDesc string The description of the userscript in the locale's language
authors string[] The authors of the translations


plugins.json

(Not implemented yet)


require.json

This file contains the npm libraries that are loaded into the runtime through the @require userscript directive.
It's an array of objects, which each have the following properties:

Property Type Description
pkgName string The name of the npm package, as in npm i <pkgName>
path string The path to the file that should be loaded, relative to the library root dir
global string The name of the global variable that the library exports
[link] boolean Whether npm link is active and the library should instead be included in the bundle