TinkerTime 🛠️

A handy collection of time-saving JavaScript utilities + a simple CLI.
Built for developers who want quick helpers without bulky dependencies.

✨ Features

• String helpers (capitalize, reverse strings)
• Random helpers (random ID, random int, pick from array)
• Date/time helpers (timestamp, days between dates)
• Array helpers (shuffle, pick random)
• Console helpers (pretty logs)
• CLI support 🎉

📦 Installation

npm install tinkertime

🖥️ Usage (JavaScript)

const tt = require('tinkertime');

// Strings
console.log(tt.capitalize("hello")); // "Hello"
console.log(tt.reverseString("world")); // "dlrow"

// Random
console.log(tt.randomInt(1, 10));   // e.g. 7
console.log(tt.randomID(12));       // e.g. "aB3xYz91LmQp"

// Date
console.log(tt.now()); // 2025-08-26T20:30:00.000Z
console.log(tt.daysBetween("2025-01-01", "2025-01-10")); // 9

// Array
console.log(tt.shuffleArray([1, 2, 3, 4])); // Random order
console.log(tt.pickRandom(["apple", "banana", "cherry"])); // Random fruit

// Console
tt.logSuccess("Everything worked!");
tt.logError("Something went wrong!");

🚀 CLI Usage

After installing globally or linking:

npm install -g tinkertime

Run tinker in your terminal:

tt randomID 10     # Generate a random 10-char ID
tt now             # Current timestamp
tt shuffle a b c d # Shuffle items
tt pick red blue   # Pick a random item

🧩 Roadmap

• More string + date utilities
• File system shortcuts
• URL/query string helpers
• Async wrappers

📜 License

HEX © 2025 Bishop Limited