🎉 simple-title-case

A smart utility to convert strings to Title Case — now with advanced rules for small words, punctuation, and CLI support. Lightweight, dependency-free, and ready for Node.js, browsers, or terminal use.

📦 What It Does

simple-title-case converts plain text into Title Case, with thoughtful support for:

✅ Small words (e.g. and, of, the) ✅ Apostrophes and hyphenated words ✅ Unicode characters (e.g. accented letters) ✅ CLI integration for terminal use ✅ Extra whitespace normalization ✅ Works in Node.js, React, or via shell commands

📁 Table of Contents

• Installation

• Usage

  • In Node.js
  • In React / Frontend
  • In the CLI

• Advanced Examples

• Why Use This?

• Local CLI Dev Setup

• Contribution

• License

🚀 Installation

📦 For Node.js / React / TypeScript

Install as a dependency:

npm install simple-title-case

🖥️ For Global CLI Usage

Install globally to use the titlecase command in your terminal:

npm install -g simple-title-case

🔧 Usage

✅ In Node.js

const titleCase = require('simple-title-case');

console.log(titleCase("john's big-day at the park"));
// ➜ "John's Big-Day at the Park"

✅ In React / Frontend

import titleCase from 'simple-title-case';

function App() {
  const input = "a tale of two cities";
  return <h1>{titleCase(input)}</h1>; 
  // Renders: "A Tale of Two Cities"
}

export default App;

🖥️ CLI Usage

📌 After installing globally:

titlecase "the quick brown fox"
# ➜ The Quick Brown Fox

📌 Pipe input into it:

echo "john's big-day at the park" | titlecase
# ➜ John's Big-Day at the Park

🧪 Advanced Examples

| Input | Output | | ------------------------------ | ------------------------------ | | "the quick brown fox" | "The Quick Brown Fox" | | "a tale of two cities" | "A Tale of Two Cities" | | "john's big-day at the park" | "John's Big-Day at the Park" | | "ÉLÉGANCE and simplicity" | "Élégance and Simplicity" | | " extra spaces " | "Extra Spaces" | | "" (empty string) | "" |

💡 Why Use This?

• ✅ No dependencies – Lightweight and fast
• ✅ Smart casing – Skips small words unless first/last
• ✅ Handles punctuation – Apostrophes and hyphens handled correctly
• ✅ Unicode support – Handles accented characters properly
• ✅ Use anywhere – Works in Node.js, frontend, CLI

⚙️ How It Works

Small Words (Excluded from Capitalization)

Small linking words are lowercased unless they are the first or last word:

a, an, and, as, at, but, by, for, in, nor, of, on, or, the, to, up, yet

🔧 For Local Development

If you're developing the CLI locally:

npm link

Then you can run it like:

titlecase "linked local usage works!"
# ➜ Linked Local Usage Works!

👨‍💻 Contribution

Found a bug or want to contribute? Pull requests and issues are welcome!

Steps:

1. Fork the repo
2. Create a feature branch (git checkout -b feat/your-feature)
3. Commit with Conventional Commits
4. Open a Pull Request

📁 GitHub Repository

https://github.com/sonumehtaskr/simple-title-case

🪪 License

MIT © Sonu Kumar