spinute/README.md

📍 A creative CLI self-introduction with beautiful animations and visual effects

# 📍 spinute

A creative CLI self-introduction with beautiful animations and visual effects.

## ✨ Features

- 🎨 **10+ Visual Effects**: Conway's Game of Life, Particle Systems, Matrix Rain, DNA Helix, and more
- 💳 **5 Animated Business Cards**: Each with unique visual styles and transitions
- 📍 **Personal Touch**: Features my favorite emojis throughout the animations
- 🔄 **Dynamic Experience**: Different animations each time you run it
- ⚡ **Fast & Smooth**: Optimized animations with smooth transitions

## 🚀 Usage

Simply run:

```bash
npx spinute
```

No installation required!

### Options

```bash
# Use a specific seed for reproducible animations
npx spinute --seed 42
npx spinute -s 12345

# Show help
npx spinute --help
```

## 🎯 What You'll See

1. **Visual Effects** (randomly selected):
   - Conway's Game of Life with patterns
   - Particle systems with emojis
   - Matrix rain with Japanese characters
   - Spiral patterns
   - DNA helix animation
   - Circuit board simulation
   - Kaleidoscope effects
   - Fireflies with emoji characters
   - Wave animations
   - Glitch art

2. **Animated Business Cards** (randomly selected):
   - Floating card with particles
   - Glitch-style card
   - Neon pulsing card
   - ASCII wave card
   - Constellation card

3. **Static Business Card** with contact information

## 🛠️ Development

```bash
# Clone the repository
git clone https://github.com/spinute/spinute.git
cd spinute

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build
npm run build

# Run built version
npm start
```

## 📦 Tech Stack

- TypeScript
- Node.js
- chalk (terminal styling)
- figlet (ASCII art)
- gradient-string (gradient effects)
- boxen (boxes in terminal)

## 📝 License

MIT

## 🌐 Connect

- Website: https://spinute.notion.site/
- GitHub: https://github.com/spinute
- X: https://x.com/spinute

---

Made with 💻 and 🍣 by spinute