simply-slugy 🏷️

A simple and powerful slug generation library supporting 44 languages for transliteration!

It helps creating and managing slugs. It provides utilities to convert strings into URL-friendly slugs, reverse slugs back into readable text, validate slugs, and customize slug generation with mappings and locale support. Perfect for SEO optimization and clean URL generation in your projects.

📌 Features

✅ Convert text to URL-friendly slugs (slugify)

✅ Convert slugs back to readable text (deslugify)

✅ Validate if a string is a valid slug

✅ Custom slug mappings for special characters

✅ Supports 44 languages for transliteration

📦 Installation

Install via npm

npm i simply-slugy

Install via yarn

yarn add simply-slugy

🚀 Usage

const simp = require('simply-slugy');

// Slugify Example
console.log(simp.slugify("Hello World!"));  
        // Output: "hello-world"

// Deslugify Example
console.log(simp.deslugify("hello-world"));  
        // Output: "Hello World"

// isValidSlug Example
console.log(simp.isValidSlug("hello-world"));  
        // Output: true
console.log(simp.isValidSlug("Hello World!"));  
        // Output: false

// Custom Slugify Example
const customMap = { "&": "and", "@": "at" };
console.log(simp.customSlugify("Rock & Roll @ 2025", customMap));  
        // Output: "rock-and-roll-at-2025"

// Slugify with Locale Example  (refer the supported languages list below)
console.log(simp.slugifyWithLocale("München ist schön", "de"));   // de : German
        // Output: "muenchen-ist-schoen"

// transliterations Example 
console.log(simp.transliterations['de']); // Output: { 'ä': 'ae', 'ö': 'oe', 'ü': 'ue', 'ß': 'ss' }

console.log(simp.transliterations['fr']); // Output: { 'é': 'e', 'è': 'e', 'à': 'a', 'ç': 'c', 'ô': 'o', 'û': 'u' }

console.log(Object.keys(simp.transliterations)); // Lists all supported languages

📜 API Reference

🌍 Supported Languages for Transliteration: