Local Development

Running your Zuplo Gateway locally

You can configure and run your Zuplo Gateway locally on your machine for development purposes using your favorite code editor.

Requirements

  • Node.js 20.0.0 or higher
  • Linux, Mac OS X, or Windows Subsystem for Linux (WSL)

Getting Started

Create a new project from scratch

  1. Create a new project using

    npm create zuplo-api@latest
    bash
    Expected output:
    cd <your-new-project-directory>
    npm install
    npm run dev
    bash
  2. Start your local gateway using npm run dev.

  3. Use the local Route Designer to create your first route.

Import your existing project

If you have been using Zuplo using the Zuplo Web Portal, you can import your project into your local machine.

  1. Connect your project to a Git repository from the Zuplo Web Portal. Connect repository

  2. Clone your project from your Git provider to your local machine.

  3. Install the necessary dependencies:

    npm install
    sh
  4. Start your Zuplo Gateway locally;

    npm run dev
    sh
  5. Use the local Route Designer to create your first route.

Limitations

While convenient and powerful, not all features of Zuplo are supported while developing locally. The following features are currently not supported when running your Zuplo Gateway locally:

  • Analytics
  • Developer Portal

Next steps