📦 @whimsy-ware/keep-it-alive

“Because even your code deserves a heartbeat.”

@whimsy-ware/keep-it-alive is the only npm package that will literally keep your code alive by printing a friendly “You’re still alive!” message every 30 seconds.
It’s useful for:

• Fun demos / code‑golf
• “Lonely” modules that need a little love
• As a joke in your README or commit messages

📥 Install

npm i @whimsy-ware/keep-it-alive 

🔧 Usage

// app.js
const keepAlive = require('@whimsy-ware/keep-it-alive')

// Start the heartbeat. Optional callback runs each tick.
const stop = keepAlive(() => {
  // Do something on every heartbeat (e.g., ping a health‑check endpoint)
})

// When you want to stop the heartbeat
// stop()

What it does

| Action | Result | |--------|--------| | keepAlive() | Logs 💖 You're still alive! every 30 s | | Pass a callback | The callback is invoked on each tick | | Call the returned function | Clears the interval – no more heartbeats |

📦 API

/**
 * Starts a heartbeat that logs every 30 seconds.
 *
 * @param cb Optional callback invoked on each tick.
 * @returns A function that stops the heartbeat.
 */
function keepAlive(cb?: () => void): () => void

🎉 Example

const keepAlive = require('@whimsy-ware/keep-it-alive')

console.log('Starting the project…')
const stop = keepAlive(() => console.log('Heartbeat tick!'))

setTimeout(() => {
  console.log('Stopping the heartbeat…')
  stop()
}, 120000)   // Stop after 2 minutes

Output:

Starting the project…
💖 You're still alive!
Heartbeat tick!
💖 You're still alive!
Heartbeat tick!
Stopping the heartbeat…

🤝 Contributing

Pull requests are welcome!

• Add more fun options (different tick intervals, custom messages)
• Improve docs or add TypeScript typings
• Create an npm script that auto‑bump the version on every release

📜 License

MIT © 2026 Whimsy Ware

📣 Spread the Love

# GitHub gist style
git add .
git commit -m "Add @whimsy-ware/keep-it-alive – keeps code alive!"
git push

“I just added @whimsy-ware/keep-it-alive to my project – it keeps my code alive! #npmjokes”

💬 FAQ

Q: Does it depend on any other libraries?
A: No. It’s a single file with no external dependencies.

Q: Will it interfere with production?

A: It only logs to the console. If you’re in a CI environment, just ignore the output or pass null as the callback.

Happy heart‑beating! ❤️