packpulse/README.md

**PackPulse** is a customizable, user-friendly, smooth, and efficient Node.js package for generating personalized greetings (or any string-based output) with ease.

# PackPulse

**PackPulse** is a customizable, user-friendly, smooth, and efficient Node.js package for showing Progress bar.

---


## 🚀 Features
- **Customizable** → Change  Progress bar prefix, styles, or output format.
- **User-Friendly** → Simple API and minimal setup.
- **Smooth & Efficient** → Lightweight and fast execution.

---


## 📦 Installation
```bash
npm install packpulse
````

---


## 🛠 Usage

```js
const packPulse = require('packpulse');
  packPulse({
      style: "customize", // "hash", "emoji", "rainbow", "dots", "customize"
      total,    // 100
      current: i,   // current percent
      barLength: 30,
      alignment: "left", // "left", "center", "right"
      color: "\x1b[33m", // Yellow
      emoji: "█"
  });
```

---


## ⚙ Demo

```js
const packPulse = require('packpulse');



async function runDemo() {
    const total = 50;

    for (let i = 0; i <= total; i++) {
        // Change style to try different bars
        packPulse({
            style: "customize", // "hash", "emoji", "rainbow", "dots", "customize"
            total,
            current: i,
            barLength: 30,
            alignment: "left", // "left", "center", "right"
            color: "\x1b[33m", // Yellow
            emoji: "█"
        });

        await new Promise(res => setTimeout(res, 100));
    }
    console.log("\n✅ Done!");
}

runDemo();

```

<img width="302" height="168" alt="image" src="https://github.com/user-attachments/assets/c35b0a40-3dc7-49b8-b81a-76230afcd8da" />
<br />
<img width="491" height="866" alt="image" src="https://github.com/user-attachments/assets/3dbd456c-f4e8-4741-bdf7-63f2d10514b3" />


---


## 🤝 Contributing

Contributions welcome!
Fork the repo → Create a branch → Make changes → Open a pull request.

---


## 📜 License

MIT © 2025 sivaprasath2004