SDK for Developers

Browser-to-printer integration, inside your app.

Embed reliable label printing into your web application with the headless TopBridge JavaScript SDK. Connect browser workflows to local and network label printers without building custom middleware.

Browser-native Zero dependencies Framework-ready
label-printing.ts
import { TopBridgeClient } from
'@appzgatenz/label-print-topbridge-js';

const client = new TopBridgeClient();

// Health, quota and printer discovery
const { printers } =
  await client.preflight.run();

// Execute the print job
await client.print.execute({
  template: 'PRICE_LABEL',
  printer: 'TSC DA220',
  products: [{
    name: 'Apple',
    price: 3.99,
    copies: 2
  }]
});
TopBridge Connected
Printer Discovered
Print Job Ready

Headless Architecture

A lightweight print layer built for modern web applications.

The TopBridge SDK gives your application a browser-native interface for discovering printers, validating the print environment and sending label jobs through the TopBridge desktop application.

No UI lock-in

Use the SDK with vanilla JavaScript or integrate it into React, Vue, Svelte and other frontend stacks.

Zero external dependencies

Install the package and work with browser-native APIs without adding a heavy client-side dependency tree.

Production-focused security

Use fixed connection endpoints, origin verification and input validation as part of a controlled browser-to-desktop workflow.

Core SDK Capabilities

Everything your application needs before it sends a label

Build a clearer print flow with structured checks, predictable printer access and a dedicated execution layer.

01

Printer Discovery

Retrieve available local and network printers through TopBridge so users can select the correct device inside your application.

client.printers.list()
02

Health Check

Confirm that the TopBridge tray application is available before the user submits a print job.

client.health.check()
03

Quota Validation

Validate print availability as part of the preflight sequence before the SDK executes the requested job.

client.quota.validate()
04

Print Execution

Send template, printer and dynamic product data in one structured request, then handle success or typed SDK errors in your own interface.

client.print.execute()

Developer Workflow

Install, connect and print

Add the SDK, check the TopBridge connection and send a structured label job directly from your application.

01

Install the SDK

Add the JavaScript package to your application.

02

Run preflight

Check TopBridge and discover available printers.

03

Send the job

Submit the template, printer and label data.

example.ts Example only
JavaScript Core
import { TopBridgeClient } from
'@appzgatenz/label-print-topbridge-js';

const client = new TopBridgeClient();

// Check TopBridge and available printers
const preflight = await client.preflight.run();

// Send a sample label job
await client.print.execute({
  template: 'PRICE_LABEL',
  printer: preflight.printers.data.defaultPrinter,
  products: [{
    name: 'Example',
    copies: 1
  }]
});
npm install @appzgatenz/label-print-topbridge-js Install package

Start Building

Add browser-to-printer label printing to your application

Review the SDK guide, install the JavaScript package and connect your first TopBridge-powered print workflow.

JavaScript Core is available now. React and Next.js wrappers are listed as coming soon.

🚀 Register Now