docs: enhance README with professional badges and links

- Add comprehensive badge collection (NPM, GitHub, CI, TypeScript)
- Improve README structure with emoji sections and table of contents
- Add extensive links section with NPM, GitHub, and documentation
- Update package.json with keywords, funding, and better homepage
- Add MIT LICENSE file
- Create professional project presentation with clear navigation

Author: 253eosam

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 253eosam
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,6 +1,20 @@
 # commit-from-branch
 
-Flexible commit message templating from branch name (ticket/segments) for Husky's `prepare-commit-msg` hook.
+<div align="center">
+
+[![NPM Version](https://img.shields.io/npm/v/@253eosam/commit-from-branch?style=flat-square&color=blue)](https://www.npmjs.com/package/@253eosam/commit-from-branch)
+[![NPM Downloads](https://img.shields.io/npm/dm/@253eosam/commit-from-branch?style=flat-square&color=green)](https://www.npmjs.com/package/@253eosam/commit-from-branch)
+[![GitHub Release](https://img.shields.io/github/v/release/253eosam/commit-from-branch?style=flat-square&color=purple)](https://github.com/253eosam/commit-from-branch/releases)
+[![License](https://img.shields.io/npm/l/@253eosam/commit-from-branch?style=flat-square&color=orange)](https://github.com/253eosam/commit-from-branch/blob/main/LICENSE)
+
+[![CI Status](https://img.shields.io/github/actions/workflow/status/253eosam/commit-from-branch/release.yml?style=flat-square&label=CI)](https://github.com/253eosam/commit-from-branch/actions)
+[![GitHub Pages](https://img.shields.io/github/deployments/253eosam/commit-from-branch/github-pages?style=flat-square&label=Demo)](https://253eosam.github.io/commit-from-branch/)
+[![Node.js](https://img.shields.io/node/v/@253eosam/commit-from-branch?style=flat-square&color=brightgreen)](https://nodejs.org/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue?style=flat-square)](https://www.typescriptlang.org/)
+
+</div>
+
+**Flexible commit message templating from branch name (ticket/segments) for Husky's `prepare-commit-msg` hook.**
 
 Automatically formats your commit messages based on your branch name, extracting Jira-style tickets (e.g., `ABC-123`) and supporting flexible templating with branch segments.
 
@@ -14,19 +28,35 @@ Automatically formats your commit messages based on your branch name, extracting
 - 🎨 **Pattern matching** - Include/exclude branches with glob patterns
 - 🏃 **Fast & lightweight** - Minimal dependencies, TypeScript-based
 
-## Installation
+
+## 📖 Table of Contents
+
+- [Demo](#-demo)
+- [Installation](#-installation)
+- [Quick Start](#-quick-start)
+- [Configuration](#-configuration)
+- [Template Variables](#-template-variables)
+- [Examples](#-examples)
+- [Debug Mode](#-debug-mode)
+- [Programmatic Usage](#-programmatic-usage)
+- [How It Works](#-how-it-works)
+- [Requirements](#-requirements)
+- [Contributing](#-contributing)
+- [Links](#-links)
+
+## 🌐 Demo
+
+**[🚀 Live Demo](https://253eosam.github.io/commit-from-branch/)** - Try the interactive demo to see how commit message templating works!
+
+## 📦 Installation
 
 ```bash
 npm install @253eosam/commit-from-branch --save-dev
 ```
 
 > **Note**: This package requires Husky v9 as a peer dependency. npm will automatically warn you if it's not installed.
 
-## Demo
-
-🌐 **[Live Demo](https://253eosam.github.io/commit-from-branch/)** - Try the interactive demo to see how commit message templating works!
-
-## Quick Start
+## 🚀 Quick Start
 
 1. **Install Husky v9** (if not already installed):
 
@@ -62,7 +92,7 @@ git commit -m "implement user authentication"
 # Result: "[ABC-123] implement user authentication"
 ```
 
-## Configuration
+## ⚙️ Configuration
 
 Add configuration to your `package.json`:
 
@@ -86,7 +116,7 @@ Add configuration to your `package.json`:
 | `includePattern` | `string \| string[]` | `["*"]`                         | Glob patterns for branches to include |
 | `exclude`        | `string[]`           | `["merge", "squash", "revert"]` | Commit sources to exclude             |
 
-## Template Variables
+## 🔧 Template Variables
 
 Use these placeholders in your format templates:
 
@@ -100,7 +130,7 @@ Use these placeholders in your format templates:
 | `${msg}`                   | Original commit message           | `implement user authentication`             |
 | `${body}`                  | Full original commit body         | Multi-line commit content                   |
 
-## Examples
+## 💡 Examples
 
 ### Basic Ticket Extraction
 
@@ -156,23 +186,23 @@ Use these placeholders in your format templates:
 }
 ```
 
-## Debug Mode
+## 🐛 Debug Mode
 
 Enable debug logging:
 
 ```bash
 BRANCH_PREFIX_DEBUG=1 git commit -m "test message"
 ```
 
-## Dry Run Mode
+## 🧪 Dry Run Mode
 
 Test without modifying commit messages:
 
 ```bash
 BRANCH_PREFIX_DRYRUN=1 git commit -m "test message"
 ```
 
-## Programmatic Usage
+## 🔌 Programmatic Usage
 
 ```typescript
 import { run } from "@253eosam/commit-from-branch";
@@ -192,7 +222,7 @@ import { initHusky } from "@253eosam/commit-from-branch/init";
 initHusky("/path/to/repo");
 ```
 
-## How It Works
+## ⚡ How It Works
 
 1. **Hook Integration**: Integrates with Husky's `prepare-commit-msg` hook
 2. **Branch Detection**: Gets current branch name using `git rev-parse --abbrev-ref HEAD`
@@ -201,13 +231,13 @@ initHusky("/path/to/repo");
 5. **Template Rendering**: Replaces placeholders with actual values
 6. **Message Formatting**: Updates commit message file with formatted result
 
-## Requirements
+## 📋 Requirements
 
 - Node.js >= 16
 - Git repository
 - Husky v9 (peer dependency)
 
-## Contributing
+## 🤝 Contributing
 
 1. Fork the repository
 2. Create a feature branch: `git checkout -b feature/my-feature`
@@ -217,6 +247,34 @@ initHusky("/path/to/repo");
 6. Push to the branch: `git push origin feature/my-feature`
 7. Submit a pull request
 
-## License
+## 🔗 Links
+
+### Package & Releases
+- **[📦 NPM Package](https://www.npmjs.com/package/@253eosam/commit-from-branch)** - Official NPM package
+- **[🚀 GitHub Releases](https://github.com/253eosam/commit-from-branch/releases)** - Release notes and downloads
+- **[🌐 Live Demo](https://253eosam.github.io/commit-from-branch/)** - Interactive demo
+
+### Development & Community
+- **[💻 Source Code](https://github.com/253eosam/commit-from-branch)** - GitHub repository
+- **[🐛 Report Issues](https://github.com/253eosam/commit-from-branch/issues)** - Bug reports and feature requests
+- **[📊 CI/CD Pipeline](https://github.com/253eosam/commit-from-branch/actions)** - Build status and automation
+- **[📈 NPM Stats](https://npmcharts.com/compare/@253eosam/commit-from-branch)** - Download statistics
+
+### Documentation
+- **[📚 API Documentation](https://github.com/253eosam/commit-from-branch#-programmatic-usage)** - Programmatic usage guide
+- **[⚙️ Configuration Guide](https://github.com/253eosam/commit-from-branch#%EF%B8%8F-configuration)** - Setup and customization
+- **[🔧 Template Variables](https://github.com/253eosam/commit-from-branch#-template-variables)** - Available placeholders
+
+## 📄 License
 
 MIT © [253eosam](https://github.com/253eosam)
+
+---
+
+<div align="center">
+
+**[⬆ Back to Top](#commit-from-branch)**
+
+Made with ❤️ by [253eosam](https://github.com/253eosam)
+
+</div>

package.json

@@ -1,7 +1,21 @@
 {
   "name": "@253eosam/commit-from-branch",
   "version": "0.2.4",
-  "description": "Flexible commit message templating from branch name (ticket/segments) for Husky prepare-commit-msg",
+  "description": "🚀 Flexible commit message templating from branch name (ticket/segments) for Husky's prepare-commit-msg hook. Automatically extracts Jira-style tickets and supports customizable templates.",
+  "keywords": [
+    "commit",
+    "git",
+    "husky",
+    "commit-msg",
+    "jira",
+    "ticket",
+    "branch",
+    "template",
+    "prepare-commit-msg",
+    "automation",
+    "typescript",
+    "cli"
+  ],
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -10,7 +24,11 @@
   "bugs": {
     "url": "https://github.com/253eosam/commit-from-branch/issues"
   },
-  "homepage": "https://github.com/253eosam/commit-from-branch#readme",
+  "homepage": "https://253eosam.github.io/commit-from-branch/",
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/253eosam"
+  },
   "type": "module",
   "main": "./dist/core.cjs",
   "module": "./dist/core.js",