random-color-toolkit

🎨 random-color-toolkit

Générateur de couleurs aléatoires pour formats hexadécimal, RGB et HSL

Un petit utilitaire qui génère des couleurs aléatoires en format hexadécimal (#RRGGBB), RGB (rgb(r,g,b)) ou HSL (hsl(h,s%,l%)). Idéal pour les développeurs frontend, les designers ou toute personne qui veut ajouter une touche de couleur dynamique dans ses projets.

📦 Installation

npm install random-color-toolkit

🚀 Utilisation

ES Module (Recommandé)

import { randomHex, randomRGB, randomHSL } from "random-color-toolkit";

// Générer une couleur hexadécimale
console.log(randomHex()); // "#3fa9f5"

// Générer une couleur RGB
console.log(randomRGB()); // "rgb(63, 169, 245)"

// Générer une couleur HSL
console.log(randomHSL()); // "hsl(204, 90%, 60%)"

CommonJS

const { randomHex, randomRGB, randomHSL } = require("random-color-toolkit");

// Utilisation identique
console.log(randomHex()); // "#a83ff5"

📖 API

randomHex()

Retourne une couleur hexadécimale au format #RRGGBB

• Retourne: string - Couleur hexadécimale (ex: "#3fa9f5")

randomRGB()

Retourne une couleur au format RGB rgb(r, g, b)

• Retourne: string - Couleur RGB (ex: "rgb(63, 169, 245)")

randomHSL()

Retourne une couleur au format HSL hsl(h, s%, l%)

• Retourne: string - Couleur HSL (ex: "hsl(204, 90%, 60%)")

🧪 Tests

Les tests sont réalisés avec Vitest.

Exécutez les tests avec :

npm test

📜 Scripts NPM

{
  "scripts": {
    "test": "vitest"
  }
}

🛠️ Développement

• Clonez le repository :

git clone https://github.com/Lil-Code30/random-color-toolkit.git

• Installez les dépendances :

npm install

• Exécutez les tests pour vérifier le fonctionnement :

npm test

🤝 Contribution

Les contributions sont les bienvenues ! Pour contribuer :

• Fork le projet
• Créez votre branche (git checkout -b feature/amazing-feature)
• Commit vos changements (git commit -m 'Add amazing feature')
• Push vers la branche (git push origin feature/amazing-feature)
• Ouvrez une Pull Request

📄 Licence

Distribué sous licence MIT. Voir le fichier LICENSE pour plus d'informations.

👨‍💻 Auteur

Ismael Loko

🔮 Historique des versions

• 1.0.2 – Mise à jour du README, gestion des versions
• 1.0.1 – Correction structure, README, et publication npm
• 1.0.0 – Version initiale avec génération de couleurs hex, RGB et HSL

⭐ N'oubliez pas de mettre une étoile sur GitHub si ce projet vous est utile !

Ce projet a été généré avec ❤️ pour la communauté JavaScript.