Nexaplot 🚀

Nexaplot adalah modul PDF Template Engine & Designer berbasis JavaScript (Vue 3 + Node.js) yang memungkinkan Anda merancang dan menghasilkan dokumen PDF secara dinamis dengan akurasi tinggi melalui antarmuka visual drag-and-drop.

Fitur Utama

• ✨ Visual Designer: Editor WYSIWYG untuk menempatkan variabel pada PDF template.
• 🎨 Nexa Palette Design: Antarmuka modern dengan gaya Glassmorphism & Dark Mode.
• 🛠️ Universal Engine: Satu engine yang sama bekerja di Browser (Vue) dan Backend (Express).
• 🧩 Zero Config CSS: Menggunakan Scoped CSS—tidak perlu instalasi Tailwind di sisi client.
• 📊 Dynamic Elements: Dukungan Teks (Bold/Italic/Fonts), Gambar, Tabel dinamis, dan QR Code.
• 📦 NPM Ready: Siap diintegrasikan ke alur kerja pengembangan modern.
• 📗 Full Documentation: Lihat DOCUMENTATION.md untuk panduan lengkap alur kerja dan skema data.

Instalasi

npm install nexaplot

Penggunaan

1. Vue Designer (NexaplotEditor)

Gunakan komponen ini untuk memberikan antarmuka desain kepada pengguna Anda.

<script setup>
import NexaplotEditor from 'nexaplot/editor';
import 'nexaplot/style.css';
import * as PDFLib from 'pdf-lib';

const onSave = ({ configString }) => {
  // Simpan 'configString' (NXCFG-...) ke database
  console.log("Encoded Config:", configString);
};
</script>

<template>
  <div style="height: 100vh">
    <NexaplotEditor :pdf-lib="PDFLib" @save="onSave" />
  </div>
</template>

2. PDF Generation (Backend/Express)

Gunakan engine untuk men-generate hasil akhir PDF di server.

import NexaplotEngine from 'nexaplot';
import * as pdfLib from 'pdf-lib';

const handleRequest = async (req, res) => {
  const licenseKey = 'NX-COMM-YOUR-KEY'; // Opsional (Trial jika kosong)
  const engine = new NexaplotEngine(pdfLib, licenseKey);
  
  // Param kedua 'configString' wajib berupa string ter-encode (NXCFG-...)
  const result = await engine.generate(bufferTemplate, configString, userData);
  
  res.setHeader('Content-Type', 'application/pdf');
  res.send(Buffer.from(result));
};

Alternatif menggunakan functional helper:

import { generatePdf } from 'nexaplot/engine';

Trial vs Pro Version

Versi Trial (tanpa license key) akan menyertakan watermark "NEXAPLOT TRIAL" pada setiap halaman PDF yang dihasilkan. Untuk menghapus watermark dan menggunakan Nexaplot dalam proyek komersial, Anda memerlukan Commercial License Key.

Hubungi Antmedia.co.id untuk aktivasi lisensi.

Lisensi

Proyek ini menggunakan lisensi MIT dengan pembatasan fitur komersial pada engine (Watermark). Lihat file LICENSE untuk informasi lebih lanjut.

English Short Version

Nexaplot is a professional PDF Template Engine & Designer. It provides a visual drag-and-drop editor for Vue 3 and a powerful rendering engine for Node.js/Express.

• Designer: import NexaplotEditor from 'nexaplot/editor'; import 'nexaplot/style.css';
• Engine (Class): import NexaplotEngine from 'nexaplot'
• Engine (Functions): import { generatePdf } from 'nexaplot/engine'

Made with ❤️ by Antmedia.co.id