@mochabug/adaptkit

@mochabug/adaptkit is the official CLI tool for developing and managing applications for the mochabug Adapt platform. Built with Node.js 24 compatibility, adaptkit streamlines the entire application development workflow.

Key Features

• Create new application projects with scaffolding
• Add vertices (tasks) to existing applications
• Emulate applications locally for testing
• Publish applications to the mochabug Adapt platform
• Manage application versioning with semantic versioning

Application Architecture

Applications are composed of vertices - the fundamental building blocks that define tasks. Each vertex consists of:

Executor (Required)

The core logic that performs tasks. Available types:

• Action - Performs tasks without external system interactions
• Cron Trigger - Executes tasks at scheduled intervals
• External Trigger - Responds to external endpoint events
• Browser - Runs tasks within a browser environment

Configurator (Optional)

Provides UI for customising executor behaviour on the mochabug Adapt platform.

Installation

npm install -g @mochabug/adaptkit

Commands

Initialize an Application Project

adaptkit init

Creates a new application with manifest.json, executor/configurator templates, and schema files.

Add Vertices to Your Application

adaptkit add

Interactively adds new vertices to your existing application project.

Emulate Application Locally

adaptkit emulate

Test your application in a local environment. Requires the mochabug Adapt sandbox:

docker run --rm -it -p 51001:51001 -p 51002:51002 -p 51003:51003 -p 51004:51004 -p 51005:51005 mochabug/adaptsandbox:latest

The 5 ports simulate different vertex types, the graphical interface, and the adaptkit publish endpoint.

Publish to mochabug Adapt

adaptkit publish

Publish your application to the mochabug Adapt platform for production use.

Version Management

adaptkit version --patch  # Increment patch version
adaptkit version --minor  # Increment minor version
adaptkit version --major  # Increment major version

Updates the semantic version in your application’s manifest.json.

Node.js 24 Compatibility

Adaptkit is built with full Node.js 24 support, leveraging modern JavaScript features and native ES modules for optimal performance and compatibility.

Application examples

For application examples see our repo mochabug/adapt-plugins