birthday-wish/README.md

Here's the updated GitHub description optimized for Bun runtime:

Here's the updated GitHub description optimized for Bun runtime:


# 🎂 Birthday Bash Whish CLI (Bun Edition) 🎉

A lightning-fast birthday celebration tool built with Bun, featuring animated greetings and interactive fun!

## ✨ Key Features

- ⚡ **Bun-Powered Performance**  
  Faster startup and execution compared to Node.js
- 🎨 **Rich Terminal Visuals**  
  - Dynamic ASCII art animations  
  - Smooth gradient text effects  
  - Interactive confetti explosions
- 🧠 **AI-Powered Wisdom**  
  Fetches daily quotes, advice, and facts from free APIs
- 🛡️ **Robust Architecture**  
  - Built with TypeScript for type safety  
  - Graceful error recovery  
  - Clean async/await patterns

## 🚀 Quick Start

```bash
# Install globally
bun install -g birthday-wish

# Run with your name
birthday-wish --name=YourName

# Debug mode
birthday-wish --name=YourName --debug
```

## 🌟 Bun Advantages

- 4x faster execution than Node.js
- Native TypeScript support (no transpilation needed)
- Lower memory footprint
- Built-in test runner

## 🛠 Built With

- [Bun](https://bun.sh) - JavaScript runtime (alternative to Node.js)
- [TypeScript](https://www.typescriptlang.org/) - Type safety
- [Gradient-String](https://github.com/bokub/gradient-string) - Terminal colors
- [Inquirer.js](https://github.com/SBoudrias/Inquirer.js) - Interactive prompts

## 📦 Installation Options

```bash
# Run directly (no install)
bunx birthday-wish --name=You

# Install locally
bun add birthday-wish

# Build from source
bun install
bun run build
```

## 📜 License  
MIT © [Shiro-cha]