Node Modules

Zuplo itself doesn't run Node.js, but instead runs a custom JavaScript engine that's designed to be fast and secure. However, the Zuplo engine is compatible with certain node modules that don't use native code or certain Node.js specific features like the file system.

Custom Modules

If you would like to use a node module, you can bundle modules inside of your own project. This process is straightforward using standard tools like ESBuild or TSDown to bundle your code along with any dependencies into a single file that's included in your Zuplo project.

You can find a complete example of how to bundle your own node modules in the Bundling Custom Node Modules example.

The process is typically as quick as running the following commands:

Code
npm install your-package-name
npx tsdown ./node_modules/your-package-name --format esm --platform browser --out-dir ./modules/third-party/your-package-name

The module can then be imported and used in your Zuplo project like so:

Code
import { YourPackage } from "./modules/third-party/your-package-name.mjs";

Be sure to test your bundled code thoroughly to ensure it works as expected in the Zuplo environment.

Bundled Node Modules

Below are the currently installed modules.

When developing in the Zuplo portal using the bundled modules, you will see a red underline on the module types. We do not provide type definitions for these modules. You can ignore these editor errors as this won't impact the build (assuming the modules are used correctly).