💕 LUVR - The Relationship CLI for Developers

CI/CD for your relationship - A powerful Command Line Interface (CLI) tool written in Rust to help developers manage their love life, track milestones, and commit to memory (literally).

🦀 Crushing bugs in code, not in relationships since 2024.

🤔 Why LUVR?

Let's be honest:

• You can mass unwrap() like a pro but not remember your anniversary date
• You debug production issues at 3 AM but forget her shoe size
• Your cargo build never fails but Valentine's Day? Oops.
• You're great at handling Option<T> but terrible at handling emotions

LUVR is the relationship management tool that speaks your language.

🚀 Installation

From crates.io (recommended)

cargo install luvr

From source

git clone https://github.com/Kay-79/luvr.git
cd luvr
cargo build --release
# Binary will be at target/release/luvr

Add to PATH (if building from source)

# Linux/macOS
cp target/release/luvr ~/.local/bin/

# Windows
# Add target\release to your PATH

✨ Features

📊 Status Check

$ luvr status

💕 LUVR STATUS REPORT 💕
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
👩 Luvr: Emily (Honey)
📊 Status: STABLE
⏱️ Uptime: 789 days (2y 1m 29d)
🎯 Next Milestone: 1024 days (1KB of love!) - in 235 days

📅 UPCOMING EVENTS
─────────────────────────────────────────────
🚨 🎂 Birthday - Emily's Birthday (in 3 days)
      └─ 🎁 Don't forget to prepare a gift!
   💕 Valentine - Valentine's Day (in 15 days)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💝 Keep the love alive! Run 'luvr tips' for advice.

🏆 Developer Milestones

Forget boring "1 month anniversary". Celebrate like a dev!

$ luvr milestone

🏆 DEVELOPER MILESTONES 🏆
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Current: 789 days together

✅ ACHIEVED:
   ✓   256 days - One byte of love!
   ✓   512 days - Half a kilobyte of love!
   ✓   365 days - v1.0 Release!

🔜 UPCOMING:
   ○  1024 days - 1KB of love! (in 235 days, 77% complete)
   ○  1337 days - Elite relationship status! (in 548 days)

📊 FUN STATS:
   Binary representation: 789 days = 1100010101 in binary
   Hexadecimal: 0x315 days of love

🚨 Panic Mode

When she asks "Do you remember my ring size?" and your life flashes before your eyes:

$ luvr info --secret

🚨 PANIC MODE ACTIVATED! 🚨
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Secret information vault:

   💍 Ring Size: 7
   👟 Shoe Size: 38
   👗 Clothing Size: M
   🎨 Favorite Color: Pastel blue (NOT green!)
   🌸 Favorite Flower: Sunflowers
   🍕 Favorite Food: Sushi (no wasabi)
   ⚠️ Allergies: Shrimp, peanuts
   ☕ Coffee Order: Oat milk latte, extra shot

📝 Relationship Commits

Log your relationship events like git commits:

$ luvr commit -m "Surprise date at fancy restaurant, she loved it!" -t date
💾 Committed to relationship log!
   [🍽️  date] Surprise date at fancy restaurant, she loved it!

$ luvr commit -m "Forgot to reply for 3 hours, minor incident" -t incident
💾 Committed to relationship log!
   [⚠️  incident] Forgot to reply for 3 hours, minor incident

$ luvr log
📜 RELATIONSHIP LOG
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   a1b2c3d4 2024-01-20 15:30 🍽️  date
   └─ Surprise date at fancy restaurant, she loved it!

   e5f6g7h8 2024-01-19 22:15 ⚠️  incident
   └─ Forgot to reply for 3 hours, minor incident

📖 Usage

Initialize

luvr init

Add important dates

# Add birthday
luvr add --date 1995-05-20 --name "Her Birthday" --event-type birthday

# Add anniversary  
luvr add --date 2022-02-14 --name "First Date" --event-type firstdate

# Add custom event
luvr add --date 2024-12-25 --name "Trip to Paris" --event-type custom --recurring false

Set secret information

luvr set --field ring-size --value "7"
luvr set --field shoe-size --value "38"
luvr set --field favorite-color --value "Pastel blue (NOT green!)"
luvr set --field allergies --value "Shrimp, peanuts"
luvr set --field coffee-order --value "Oat milk latte, extra shot"

# Custom fields
luvr set --field "custom:first-movie" --value "Inception"

Update relationship status

luvr set-status STABLE     # All good! 💚
luvr set-status BUILDING   # Growing stronger 🔨
luvr set-status DEBUGGING  # Working through issues 🐛
luvr set-status MERGING    # Moving in together 💒
luvr set-status DEPLOYING  # Getting married! 🚀

View events

luvr events         # Upcoming events
luvr events --all   # All events including past

Remove events

luvr rm <event-id>

Export data

luvr export                       # Print to stdout
luvr export --output backup.json  # Save to file

Get tips

luvr tips

🏷️ Log Tags

🎯 Developer Milestones

📁 Data Storage

All data is stored in ~/.luvr/data.json. It's just JSON, so you can:

• Manually back it up
• Edit it (if you know what you're doing)
• Migrate it between machines
• Inspect it for debugging

🤝 Contributing

Found a bug? Have a feature idea? PRs welcome!

Some ideas:

• Desktop notifications
• Calendar integration
• Gift suggestions based on saved preferences
• Integration with flower delivery APIs
• Relationship analytics dashboard

👤 Author

Kay-79 - GitHub

📝 License

MIT License - Because love should be open source.

See LICENSE for more details.

Remember: A good relationship is like clean code —
well-documented, regularly maintained, and crash-free! 💕

Made with ❤️ by Kay-79 for developers who love.

"Reducing breakup rates caused by memory leaks in the dev brain."