Luma

Beautiful console logs & toast notifications for modern web apps.

---

✨ Features

• 🎨 Beautiful, consistent console logs
• 🔥 Premium toast notifications (queue, progress bar, hover pause)
• 🌗 Light / Dark / Auto theme
• ⚡ Zero dependencies
• 📦 Tiny bundle size
• 🧩 Works with any frontend stack
• 🧪 Includes a full interactive demo

---

🚀 Demo

👉 Live Demo:
https://donatodelpeschio.github.io/luma/demo/

---

📦 Installation

NPM

npm install luma-console
import luma from "luma-console";
luma.success("Luma is ready!");

CDN

<script src="https://cdn.jsdelivr.net/npm/luma-console/dist/luma.min.js"></script>
<script>
  luma.success("Luma loaded from CDN!");
</script>

---

🧪 Usage

Basic Logs

luma.log("Hello world");
luma.success("Operation completed");
luma.error("Something went wrong");
luma.warn("Be careful");
luma.info("Useful information");

---

Toast Notifications

luma.toast.success("Saved!");
luma.toast.error("Error!");
luma.toast.warn("Warning!");
luma.toast.info("Info message");

---

Box

luma.box("This is a box message");

---

Group

luma.group("Loading data");
luma.log("Step 1");
luma.log("Step 2");
luma.groupEnd();

---

Timer

const t = luma.timer("Process");
setTimeout(() => t.end(), 500);

---

🎨 Themes

luma.config({
  theme: "light" // "dark" | "auto"
});

---

🧱 File Structure

luma/
├── dist/
│   ├── luma.js
│   ├── luma.min.js
│   └── *.map
├── src/
│   └── luma.js
└── demo/
    ├── index.html
    ├── style.css
    └── script.js

---

❤️ Support the Project

If Luma helps you, consider supporting the project:

👉 Buy me a coffee

👉 Sponsor on GitHub

---

📄 License

MIT License — free for personal and commercial use.

---

👨‍💻 Author

Donato del Peschio

Freelance Technical Architect & Developer

https://github.com/DonatoDelPeschio