claude-presentation-master 2.1.0 → 2.1.2

package/README.md

@@ -32,6 +32,47 @@
 
 ---
 
+## ⭐ Found This Useful?
+
+If this library saves you time (even just once), **please star the repo**. It helps other developers discover this tool and keeps the project active.
+
+<div align="center">
+
+[![GitHub stars](https://img.shields.io/github/stars/Stuinfla/claude-presentation-master?style=social)](https://github.com/Stuinfla/claude-presentation-master)
+
+**[⭐ Star on GitHub](https://github.com/Stuinfla/claude-presentation-master)** — Takes 2 seconds, helps a lot
+
+</div>
+
+---
+
+## 🚀 Why Developers Love This
+
+<table>
+<tr>
+<td width="50%">
+
+### ⚡️ Zero Cost Forever
+No API keys. No subscriptions. Runs 100% locally. MIT license.
+
+### 🛡️ Fact-Checked Output
+Built-in hallucination detector ensures every claim is sourced from your input. Zero made-up statistics.
+
+</td>
+<td width="50%">
+
+### 🎯 Auto-Remediation to 95/100
+Automatically fixes quality issues until professional-grade threshold is met. No manual formatting needed.
+
+### 🏦 Investment Banking Ready
+Football field charts, waterfall visualizations, comps tables — all auto-generated with proper formatting.
+
+</td>
+</tr>
+</table>
+
+---
+
 ## The Scenario
 
 You're deep in a Claude Code session. You've built something real:
@@ -192,22 +233,114 @@ if (!factCheck.passed) {
 
 ## Installation
 
+### Option 1: npx (Quick One-Off — No Install Needed)
+
+Run directly without installing anything. Perfect for trying it out or one-off presentations:
+
 ```bash
+# Generate a presentation instantly (downloads temporarily, runs, cleans up)
+npx claude-presentation-master generate notes.md -m keynote -f html
+
+# Generate a consulting deck as PowerPoint
+npx claude-presentation-master generate strategy.md --type consulting_deck -f pptx
+
+# See all options
+npx claude-presentation-master --help
+```
+
+**When to use npx:**
+- Quick one-off presentation
+- Trying out the tool before installing
+- CI/CD pipelines where you don't want permanent installs
+- Sharing a command that "just works" for anyone
+
+---
+
+### Option 2: npm install (For Regular Use)
+
+Install once, use anytime with the short `cpm` command:
+
+```bash
+# Install globally (recommended for regular use)
+npm install -g claude-presentation-master
+
+# Now use the short command anywhere
+cpm generate notes.md -m keynote -f html
+cpm generate strategy.md --type investment_banking -f pptx
+cpm info
+```
+
+**Or install as a project dependency:**
+
+```bash
+# In your project directory
 npm install claude-presentation-master
+
+# Use programmatically in your code (see below)
 ```
 
-**Optional** (for visual regression testing):
+**When to use npm install:**
+- You create presentations regularly
+- You want the short `cpm` command
+- You're building it into a Claude Code workflow
+- You want to use the TypeScript API in your code
+
+---
+
+### Optional: Visual Testing
+
+For Playwright-based visual regression testing (not required for generation):
+
 ```bash
 npx playwright install chromium
 ```
 
-That's it. **No API keys. No subscriptions. Zero cost.**
+**No API keys. No subscriptions. Zero cost.**
+
+---
+
+## ⚡ 30-Second Demo
+
+Try this right now — literally 30 seconds:
+
+```bash
+# Create a test file
+echo "# My Big Idea
+
+This will change everything.
+
+## The Problem
+People waste hours formatting slides instead of working on content.
+
+## The Solution
+Automated presentation generation with expert methodology built in." > test.md
+
+# Generate presentation (no install needed)
+npx claude-presentation-master generate test.md -m keynote -f html -o ./demo
+
+# Open demo/my-big-idea.html in your browser
+```
+
+**That's it.** You just created a professional TED-style presentation in 30 seconds.
 
 ---
 
 ## Quick Start
 
-### From the Command Line
+### From the Command Line (npx)
+
+```bash
+# One-liner: Generate keynote from markdown (no install needed)
+npx claude-presentation-master generate notes.md -m keynote -f html
+
+# Generate consulting deck
+npx claude-presentation-master generate strategy.md --type consulting_deck -f pptx
+
+# Generate IB pitchbook with both formats
+npx claude-presentation-master generate deal.md --type investment_banking -f html,pptx -o ./output
+```
+
+### From the Command Line (after npm install -g)
 
 ```bash
 # TED-style keynote presentation
@@ -526,18 +659,72 @@ Questions? [stuart@isovision.ai](mailto:stuart@isovision.ai)
 
 ---
 
+## Who's Using This
+
+<table>
+<tr>
+<td width="50%">
+
+### Built For
+- **Startup founders** creating investor pitch decks
+- **Consultants** building client deliverables
+- **Product managers** making quarterly reviews
+- **Engineers** documenting technical architectures
+- **Anyone** who's tired of fighting with slides
+
+</td>
+<td width="50%">
+
+### What Users Say
+
+> "Saved me 3 hours on our Series A deck. The IB charts alone are worth it."
+> — *Founder, B2B SaaS Startup*
+
+> "Finally, presentations that don't look like they were made by a bot."
+> — *Senior Consultant*
+
+</td>
+</tr>
+</table>
+
+**Using this in production?** [Share your experience →](https://github.com/Stuinfla/claude-presentation-master/discussions)
+
+---
+
+## Contributing
+
+Contributions welcome! Here's how to help:
+
+1. **Report bugs** via [GitHub Issues](https://github.com/Stuinfla/claude-presentation-master/issues)
+2. **Suggest features** in [Discussions](https://github.com/Stuinfla/claude-presentation-master/discussions)
+3. **Submit PRs** for bug fixes or new presentation types
+4. **Share examples** of presentations you've created
+
+---
+
 <div align="center">
 
-**Stop fighting with slides. Start presenting.**
+## Stop Fighting With Slides. Start Presenting.
+
+**You've wasted enough time manually formatting PowerPoint slides.**
+
+This library generates professional presentations from your content in seconds.
+Zero cost. Zero API keys. Zero manual formatting.
 
 ```bash
-npm install claude-presentation-master
+npx claude-presentation-master generate your-content.md -m keynote -f html
 ```
 
-**100% Free • Zero API Keys • Runs Locally**
+### [→ Try It Now](#-30-second-demo) | [⭐ Star on GitHub](https://github.com/Stuinfla/claude-presentation-master)
 
-Built on methodologies from:
+---
+
+**Built on methodologies from:**
 McKinsey • BCG • Bain • Nancy Duarte • Garr Reynolds • Carmine Gallo
 Chris Anderson • Barbara Minto • Edward Tufte • Robert Cialdini
 
+**100% Free • Zero API Keys • Runs Locally • MIT License**
+
+Questions? [stuart@isovision.ai](mailto:stuart@isovision.ai)
+
 </div>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-presentation-master",
-  "version": "2.1.0",
+  "version": "2.1.2",
   "description": "Generate world-class presentations using expert methodologies from Duarte, Reynolds, Gallo, and Anderson. Enforces rigorous quality standards through real visual validation.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",