🛠️Installation & Setup

Welcome to the part where everything actually comes together. This is where you install the DevPayr SDK for your environment, set it up properly, and prepare your app to start validating licenses like a professional.

Whether you're building a backend service, a frontend app, a Python tool, or a PHP/Laravel system, DevPayr gives you the flexibility to integrate however you prefer.

Let’s get everything installed and ready to go. 🚀

🟦 Node.js — Installation & Basic Setup

If you're using Node.js (Express, Next.js, NestJS, CLI tools, or anything JavaScript-powered), installing DevPayr is straightforward.

Install Using npm

npm install @xultech/devpayr

Install Using yarn

yarn add @xultech/devpayr

Setup (Basic Example)

import { DevPayr } from '@xultech/devpayr';

DevPayr.bootstrap({
  license: 'YOUR_LICENSE_KEY',
  action: 'boot',
  onReady: (res) => console.log('SDK ready:', res)
});

🐘 PHP — Installation & Basic Setup

You can use DevPayr inside Laravel, Symfony, or even pure PHP scripts.

Install via Composer

composer require xultech/devpayr-php-sdk

Setup (Basic Example)

use DevPayr\DevPayr;

DevPayr::bootstrap([
        'license'        => 'YOUR-LICENSE-KEY',
        'injectables'    => true,
        'invalidBehavior'=> 'modal', // Options: modal, redirect, silent, log
    ]);

😌 Note: The PHP SDK plays extremely well with Laravel’s service container… but it also works fine in a lonely index.php file in a random folder. No judgment.

---

🟨 Frontend (Browser) — Installation & Setup

You have two options depending on how your project is structured.

Option 1: Browser (CDN)

Perfect for static sites, templates, themes, WordPress-like environments, and simple HTML/JS setups.

<script src="https://cdn.jsdelivr.net/npm/@devpayr/frontend-sdk@latest/dist/devpayr-frontend.js"></script>

Option 2: Install via npm (for Webpack, Vite, Next.js, etc.)

npm i @devpayr/frontend-sdk

Setup (Flexible Example)

You can name your config object anything — DevPayr will detect it.

window.sdkConfig = {
  license: 'YOUR_LICENSE_KEY',
  onReady: () => console.log('SDK Loaded')
};

💡 Tip: Unlike backend SDKs, the frontend SDK lets you disguise or restructure your licensing code however you want. Helpful when you don't want users to simply "delete that one script" to bypass licensing.

🐍 Python — Installation & Setup

Great for automation scripts, CLI tools, backend services, or anything Python-powered.

Option 1: Install via pip (Recommended)

pip install devpayr-python-sdk

Option 2: Install from Source

git clone https://github.com/xultech/devpayr-python-sdk.git
cd devpayr-python-sdk
pip install -e .

Setup (Basic Example)

from devpayr import DevPayr

DevPayr.bootstrap({
    "license": "your-license-key",
    "secret": "your-shared-secret",
    "injectables": True,
    "onReady": lambda data: print("✅ License valid:", data),
    "invalidBehavior": "modal",  # Options: modal, redirect, log, silent
})

🐍 Note: Python developers always love editable installs (pip install -e .) — just don’t delete the folder afterward… unless you enjoy debugging existential errors.