Skip to main content

Lovable Prompt

Add native printing functionality to my app using the Despia SDK from: https://www.npmjs.com/package/despia-nativeFirst, install the package: npm install despia-nativeThen import it: import despia from 'despia-native'Create a printing system that uses print URLs like: despia("printitem://?jobName={PRINT-NAME}&printItem={CDN-FILE-URL}") to open the native print dialog and allow users to print documents and images through their device’s built-in printing system.
This feature requires native capabilities which will be fully provided by the “despia-native” npm package, no additional native libraries are needed!
Important: Served files via HTTPS must have proper content-type headers for optimal printing functionality.Please follow the installation instructions for the “despia-native” npm package closely, and do not modify my instructions. Implementation as mentioned is critical.
How it works: Despia acts as a bridge between your Lovable app and native mobile printing systems. When users tap a print button, Despia opens the device’s native print dialog with the specified document or image, allowing users to select their printer, adjust print settings (copies, page range, orientation), and send the job to any connected or nearby printer. Supports both images and PDF documents.

​
Installation

Install the Despia package from NPM: 
npm install despia-native

​
Usage

​
1. Import the SDK

import despia from 'despia-native';

​
2. Execute Print Job

Call the despia() function with a Print URL containing the required parameters: 
despia("printitem://?jobName=Shipping Label&printItem=https://example.com/cdn/label.pdf");

​
URL Parameters

  • jobName (required): The name of the print job that will appear in the print dialog and printer queue
  • printItem (required): The HTTPS URL of the image or PDF file to print

​
Example Use Cases

Printing a PDF document: 
despia("printitem://?jobName=Invoice #12345&printItem=https://cdn.example.com/invoices/12345.pdf");
Printing an image: 
despia("printitem://?jobName=Product Photo&printItem=https://cdn.example.com/images/product-001.jpg");
Printing a shipping label: 
despia("printitem://?jobName=Shipping Label&printItem=https://api.example.com/labels/generate?orderId=789");

​
File Server Requirements

Files served via HTTPS must have proper headers:
  • Content-Type: Appropriate MIME type for the file:
    • PDF: application/pdf
    • JPEG: image/jpeg
    • PNG: image/png
    • GIF: image/gif
    • WebP: image/webp
  • CORS Headers: Ensure proper CORS configuration if files are hosted on a different domain
  • HTTPS Required: All print items must be served over HTTPS for security

​
Resources

  • NPM Package
  • View full NPM documentation for additional configuration options

​
Lovable Integration

This SDK is optimized for Lovable’s prompt-based AI builder, enabling quick integration of native printing capabilities into your generated apps. For additional support or questions, please contact our support team at [email protected]