📦 Installation

npm install canvaxsifat

🚀 Quick Start

CommonJS

const canvaxsifat = require("canvaxsifat");

ESModule / TypeScript

import canvaxsifat from "canvaxsifat";

✨ Features

| Feature | Description | |---------|-------------| | 🪟 Open Source | Fully transparent, no privacy concerns | | 💪 Easy API | Simple, chainable methods for all card types | | 🚀 High Performance | Skia-based rendering via @napi-rs/canvas | | 🔒 TypeScript Support | Full .d.ts type definitions included | | 🎨 50+ Options | Borders, badges, gradients, overlays & more | | 🤖 Multi-Platform | Works with Discord, Telegram, WhatsApp, Messenger bots | | 🛠️ OOP Design | Object-oriented, chainable builder pattern | | 🔡 Custom Fonts | Register any .ttf / .otf font |

🤖 Supported Bot Platforms

Canvaxsifat generates image Buffers — compatible with any Node.js bot framework:

| Platform | Framework / Library | |----------|-------------------| | Discord | discord.js, Eris | | Telegram | Telegraf, node-telegram-bot-api | | WhatsApp | Baileys (whatsapp-web.js / @whiskeysockets/baileys) | | Facebook Messenger | Mirai, fbgraph, messenger-bot | | Multi-Platform | GOAT Bot v2, Fca-utils, Mirai Bot |

📦 Examples

🏆 Rank Card

const canvaxsifat = require("canvaxsifat");

const rank = new canvaxsifat.Rank()
  .setAvatar("https://example.com/avatar.png", null, false)
  .setBanner("https://example.com/banner.png", true)
  .setBadges(["Staff"], false, true)
  .setBorder(["#22274a", "#001eff"], "vertical")
  .setCurrentXP(400)
  .setRequiredXP(3000)
  .setRank(3, "RANK", true)
  .setLevel(10, "LEVEL")
  .setStatus("online")
  .setProgressBar(["#14C49E", "#FF0000"], "GRADIENT", true)
  .setUsername("Sifat", "6966", "#FFFFFF")
  .setCreatedTimestamp(new Date("2017-09-22").getTime());

const buffer = await rank.build("Cascadia Code PL");

👋 Welcome / Leave Card

const canvaxsifat = require("canvaxsifat");

const welcomer = new canvaxsifat.WelcomeLeave()
  .setAvatar("https://example.com/avatar.png")
  .setBackground("COLOR", "#000000")
  .setTitulo("Welcome ! SIFAT#6966", "#FFFFFF")
  .setSubtitulo("Just joined TESTING THE PROJECT - Member #34", "#FFFFFF")
  .setOpacityOverlay(1)
  .setColorCircle("#FFFFFF")
  .setColorOverlay("#5865F2")
  .setTypeOverlay("ROUNDED");

const buffer = await welcomer.build("Cascadia Code PL, Noto Color Emoji");

🎵 Spotify Card

const canvaxsifat = require("canvaxsifat");

const spotify = new canvaxsifat.Spotify()
  .setAuthor("SAIKO")
  .setAlbum("SAKURA")
  .setStartTimestamp(Date.now() - 10000)
  .setEndTimestamp(Date.now() + 50000)
  .setImage("https://i.scdn.co/image/ab67616d00001e02e346fc6f767ca2ac8365fe60")
  .setTitle("YO LO SOÑÉ");

const buffer = await spotify.build("Cascadia Code PL, Noto Color Emoji");

🔡 Register Custom Fonts

const { registerFont } = require("canvaxsifat");

registerFont("./fonts/MyFont.ttf", "MyFont");

📖 Full A-to-Z Bot Guide

See GUIDE.md for complete examples for every supported platform:

• Discord.js
• Telegraf (Telegram)
• Baileys (WhatsApp)
• GOAT Bot v2
• Mirai / Facebook Messenger

📄 License

GPL-3.0 © SIFAT