mani-calc 2.1.0 → 2.1.1

package/PUBLISHING_GUIDE.md

@@ -1,291 +0,0 @@
-# 📦 Publishing Mani-Calc to NPM
-
-## ✅ Pre-Publishing Checklist
-
-Before publishing, let's make sure everything is ready:
-
-- [x] Package name: `mani-calc` (unique and available)
-- [x] Version: `1.1.0`
-- [x] All files committed to Git
-- [x] README.md is comprehensive
-- [x] LICENSE file exists (MIT)
-- [x] package.json is properly configured
-- [x] Tests are passing
-- [x] Dependencies are installed
-
----
-
-## 🚀 Step-by-Step Publishing Guide
-
-### Step 1: Create NPM Account (if you don't have one)
-
-Visit: https://www.npmjs.com/signup
-
-Or use the command line:
-```bash
-npm adduser
-```
-
-### Step 2: Login to NPM
-
-```bash
-npm login
-```
-
-You'll be prompted for:
-- **Username**: Your npm username
-- **Password**: Your npm password
-- **Email**: Your email (will be public)
-- **One-time password**: If you have 2FA enabled
-
-### Step 3: Verify Login
-
-```bash
-npm whoami
-```
-
-This should display your npm username.
-
-### Step 4: Test Package Locally (Optional but Recommended)
-
-```bash
-# Create a tarball to see what will be published
-npm pack
-
-# This creates mani-calc-1.1.0.tgz
-# You can inspect it to see what files will be included
-```
-
-### Step 5: Publish to NPM
-
-```bash
-npm publish
-```
-
-**That's it!** 🎉
-
----
-
-## 📋 What Gets Published
-
-Based on your `.gitignore` and `package.json`, these files will be published:
-
-### ✅ Included
-- `bin/` - CLI scripts
-- `src/` - Source code
-- `test/` - Tests
-- `README.md` - Documentation
-- `LICENSE` - MIT License
-- `CHANGELOG.md` - Version history
-- `QUICKSTART.md` - Quick start guide
-- `EXAMPLES.md` - Usage examples
-- `ARCHITECTURE.md` - Technical docs
-- `CONTRIBUTING.md` - Contribution guide
-- `OVERLAY_MODE.md` - Overlay mode docs
-- `package.json` - Package config
-
-### ❌ Excluded (via .gitignore)
-- `node_modules/` - Dependencies
-- `.vscode/` - Editor config
-- `*.log` - Log files
-- `.env` - Environment files
-
----
-
-## 🎯 After Publishing
-
-### 1. Verify Publication
-
-Visit: https://www.npmjs.com/package/mani-calc
-
-You should see your package!
-
-### 2. Test Installation
-
-```bash
-# In a different directory
-npm install -g mani-calc
-
-# Test it
-mani-calc "2 + 3 * 5"
-```
-
-### 3. Create GitHub Release
-
-1. Go to: https://github.com/Maniredii/mani-calc/releases
-2. Click "Create a new release"
-3. Tag: `v1.1.0`
-4. Title: `v1.1.0 - Overlay Mode Release`
-5. Description: Copy from `RELEASE_NOTES_v1.1.0.md`
-6. Publish release
-
-### 4. Update README Badge
-
-Your npm version badge will now work:
-```markdown
-[![npm version](https://img.shields.io/npm/v/mani-calc.svg)](https://www.npmjs.com/package/mani-calc)
-```
-
----
-
-## 🔄 Updating the Package (Future)
-
-When you want to publish updates:
-
-### 1. Update Version
-
-```bash
-# For bug fixes (1.1.0 → 1.1.1)
-npm version patch
-
-# For new features (1.1.0 → 1.2.0)
-npm version minor
-
-# For breaking changes (1.1.0 → 2.0.0)
-npm version major
-```
-
-This automatically:
-- Updates `package.json`
-- Creates a git commit
-- Creates a git tag
-
-### 2. Push Changes
-
-```bash
-git push origin main --tags
-```
-
-### 3. Publish
-
-```bash
-npm publish
-```
-
----
-
-## 🛠️ Troubleshooting
-
-### Error: "Package name already exists"
-
-If `mani-calc` is taken, you'll need to:
-1. Choose a different name (e.g., `@yourusername/mani-calc`)
-2. Update `package.json` name field
-3. Try publishing again
-
-### Error: "You must be logged in"
-
-```bash
-npm login
-```
-
-### Error: "You do not have permission"
-
-Make sure you're logged in as the correct user:
-```bash
-npm whoami
-```
-
-### Error: "Version already published"
-
-You can't republish the same version. Bump the version:
-```bash
-npm version patch
-npm publish
-```
-
----
-
-## 📊 NPM Package Stats
-
-After publishing, you can track:
-
-- **Downloads**: https://npm-stat.com/charts.html?package=mani-calc
-- **Package page**: https://www.npmjs.com/package/mani-calc
-- **Unpkg CDN**: https://unpkg.com/mani-calc/
-
----
-
-## 🎯 Marketing After Publishing
-
-### 1. Share on Social Media
-
-**Twitter/X:**
-```
-🎉 Just published mani-calc v1.1.0 to npm!
-
-⚡ Spotlight-style calculator for Windows
-🎨 NEW: Floating search box (Alt+Space)
-💻 System commands (sleep, lock, etc.)
-🔄 Unit conversions & natural language
-
-npm install -g mani-calc
-
-https://www.npmjs.com/package/mani-calc
-https://github.com/Maniredii/mani-calc
-```
-
-### 2. Post on Reddit
-
-Subreddits:
-- r/node
-- r/javascript
-- r/Windows
-- r/productivity
-- r/programming
-
-### 3. Submit to Product Hunt
-
-https://www.producthunt.com/posts/create
-
-### 4. Write a Blog Post
-
-Platforms:
-- Dev.to
-- Hashnode
-- Medium
-
-### 5. Create a Demo Video
-
-Record yourself using:
-- Windows Search integration
-- Overlay mode
-- System commands
-
-Upload to YouTube and link in README.
-
----
-
-## 📈 Success Metrics
-
-Track these after publishing:
-
-- **Week 1 Goal**: 100 downloads
-- **Month 1 Goal**: 500 downloads
-- **GitHub Stars**: 50+
-- **Issues/PRs**: Community engagement
-
----
-
-## 🎉 Ready to Publish!
-
-Your package is production-ready. Just run:
-
-```bash
-npm login
-npm publish
-```
-
-And you're live! 🚀
-
----
-
-## 📞 Need Help?
-
-- NPM Docs: https://docs.npmjs.com/
-- Publishing Guide: https://docs.npmjs.com/cli/v8/commands/npm-publish
-- Package Naming: https://docs.npmjs.com/cli/v8/configuring-npm/package-json#name
-
----
-
-**Good luck with your launch!** 🎊

package/QUICK_PUBLISH.md

@@ -1,108 +0,0 @@
-# 🚀 Quick Publishing Commands
-
-## Step 1: Login to NPM
-
-```bash
-npm login
-```
-
-**You'll be asked for:**
-- Username
-- Password  
-- Email
-- One-time password (if 2FA enabled)
-
-**Don't have an npm account?**
-Create one at: https://www.npmjs.com/signup
-
----
-
-## Step 2: Verify Login
-
-```bash
-npm whoami
-```
-
-Should show your npm username.
-
----
-
-## Step 3: Publish!
-
-```bash
-npm publish
-```
-
-**That's it!** Your package will be live at:
-https://www.npmjs.com/package/mani-calc
-
----
-
-## 🎉 After Publishing
-
-### Test Installation
-```bash
-npm install -g mani-calc
-mani-calc "2 + 3 * 5"
-```
-
-### Share the News!
-```
-🎉 mani-calc v1.1.0 is now on npm!
-
-⚡ Spotlight for Windows
-🎨 Floating search box (Alt+Space)
-💻 System commands
-🔄 Unit conversions
-
-npm install -g mani-calc
-
-https://www.npmjs.com/package/mani-calc
-```
-
----
-
-## 📊 Your Package Info
-
-- **Name**: `mani-calc`
-- **Version**: `1.1.0`
-- **Description**: Spotlight-style instant calculator for Windows Search
-- **License**: MIT
-- **Repository**: https://github.com/Maniredii/mani-calc
-
----
-
-## ⚠️ Important Notes
-
-1. **Package name must be unique** - `mani-calc` should be available
-2. **Can't unpublish** - After 24 hours, you can only deprecate
-3. **Version must be unique** - Can't republish same version
-4. **Email will be public** - Your npm email is visible
-
----
-
-## 🔄 Future Updates
-
-```bash
-# Update version
-npm version patch  # 1.1.0 → 1.1.1
-npm version minor  # 1.1.0 → 1.2.0
-npm version major  # 1.1.0 → 2.0.0
-
-# Push to GitHub
-git push origin main --tags
-
-# Publish
-npm publish
-```
-
----
-
-**Ready? Run these commands:**
-
-```bash
-npm login
-npm publish
-```
-
-🚀 **Let's make mani-calc available to the world!**

package/RELEASE_NOTES_v1.1.0.md

@@ -1,262 +0,0 @@
-# 🎉 Mani-Calc v1.1.0 - Overlay Mode Release!
-
-## ✨ What's New
-
-### 🎨 Overlay Mode - The Game Changer!
-
-You asked for improvements, and we delivered! **Mani-Calc now has a beautiful floating search box** that appears anywhere on your screen with a simple keyboard shortcut!
-
----
-
-## 🚀 New Features
-
-### 1. **Floating Search Box**
-- Press **`Alt+Space`** anywhere in Windows
-- Beautiful glassmorphism design
-- Always-on-top overlay
-- Auto-hide when you click outside
-- Smooth animations
-
-### 2. **System Commands**
-Control your computer with simple commands:
-
-| Command | Action |
-|---------|--------|
-| `sleep` | Put computer to sleep |
-| `shutdown` | Shutdown computer |
-| `restart` | Restart computer |
-| `lock` | Lock computer |
-| `logout` | Log out current user |
-| `empty recycle bin` | Empty recycle bin |
-| `volume up` | Increase volume |
-| `volume down` | Decrease volume |
-| `mute` | Mute volume |
-| `unmute` | Unmute volume |
-
-### 3. **Live Preview**
-- See results as you type
-- Instant feedback
-- No need to press Enter for simple calculations
-
-### 4. **Enhanced UI**
-- Glassmorphism design (semi-transparent, blurred background)
-- Smooth slide-down animations
-- Color-coded results (success, error, system commands)
-- Keyboard shortcuts displayed
-
----
-
-## 📖 How to Use
-
-### Start Overlay Mode
-```bash
-npm run overlay
-
-# Or after global install
-mani-calc-overlay
-```
-
-### Use the Hotkey
-Press **`Alt+Space`** anywhere in Windows!
-
-### Examples
-```
-Alt+Space → "2 + 3 * 5" → Enter
-Result: ✓ 2 + 3 * 5 = 17
-
-Alt+Space → "10 km to miles" → Enter
-Result: ✓ 10 km = 6.21 miles
-
-Alt+Space → "sleep" → Enter
-Result: ✓ System going to sleep...
-
-Alt+Space → "lock" → Enter
-Result: ✓ Locking computer...
-```
-
----
-
-## 🎯 Why This is Amazing
-
-### Before
-1. Open Calculator app
-2. Type calculation
-3. Copy result
-4. Switch back to work
-
-### After
-1. Press `Alt+Space`
-2. Type calculation
-3. Done! (result auto-copied)
-
-**That's 3x faster!** ⚡
-
----
-
-## 📁 New Files
-
-- `src/ui/floating-search.js` - Floating search box logic
-- `src/ui/overlay.html` - Beautiful UI
-- `bin/overlay.js` - Overlay mode entry point
-- `OVERLAY_MODE.md` - Complete documentation
-
----
-
-## 🔧 Technical Details
-
-### Stack
-- **Electron** - For native window management
-- **Global Shortcuts** - `Alt+Space` hotkey
-- **IPC** - Communication between UI and backend
-- **Glassmorphism CSS** - Modern, beautiful design
-
-### Performance
-- **Memory**: ~50-80 MB (Electron overhead)
-- **CPU**: <1% when idle
-- **Startup**: ~2 seconds
-- **Response**: <100ms
-
----
-
-## 📊 Comparison
-
-| Feature | v1.0.0 | v1.1.0 |
-|---------|--------|--------|
-| **Windows Search** | ✅ | ✅ |
-| **CLI** | ✅ | ✅ |
-| **Interactive Mode** | ✅ | ✅ |
-| **Overlay Mode** | ❌ | ✅ NEW! |
-| **System Commands** | ❌ | ✅ NEW! |
-| **Live Preview** | ❌ | ✅ NEW! |
-| **Global Hotkey** | ❌ | ✅ NEW! |
-
----
-
-## 🎨 UI Screenshots
-
-The overlay features:
-- **Glassmorphism design** - Semi-transparent with blur effect
-- **Smooth animations** - Slide-down results
-- **Color-coded feedback** - Green for success, red for errors, orange for system commands
-- **Keyboard shortcuts** - Displayed at bottom
-- **Auto-focus** - Input ready when you open it
-
----
-
-## 🗺️ Roadmap Update
-
-### ✅ Completed (v1.1.0)
-- [x] Floating search box overlay
-- [x] Global hotkey support
-- [x] System commands
-- [x] Live preview
-- [x] Glassmorphism UI
-
-### 🔜 Coming Next (v1.2.0)
-- [ ] Custom themes
-- [ ] Plugin system
-- [ ] File search integration
-- [ ] Web search integration
-- [ ] Clipboard history
-- [ ] Multi-monitor support
-
----
-
-## 📖 Documentation
-
-All documentation has been updated:
-
-- **README.md** - Added overlay mode section
-- **OVERLAY_MODE.md** - NEW: Complete overlay guide
-- **CHANGELOG.md** - v1.1.0 release notes
-- **package.json** - Updated to v1.1.0
-
----
-
-## 🚀 Installation
-
-### For New Users
-```bash
-npm install -g mani-calc
-npm run overlay
-```
-
-### For Existing Users
-```bash
-npm update -g mani-calc
-npm run overlay
-```
-
----
-
-## 💡 Tips & Tricks
-
-### 1. Auto-Start on Boot
-Add to Windows Startup folder for always-available calculator
-
-### 2. Customize Hotkey
-Edit `src/ui/floating-search.js` to change `Alt+Space` to your preference
-
-### 3. Add Custom Commands
-Edit `floating-search.js` to add your own system commands
-
-### 4. Change Theme
-Edit `overlay.html` CSS for dark mode or custom colors
-
----
-
-## 🎯 Use Cases
-
-### Quick Math While Working
-```
-Working in Excel → Alt+Space → "2500 * 0.15" → Enter
-Result copied → Paste in Excel
-```
-
-### System Control
-```
-Finishing work → Alt+Space → "lock" → Enter
-Computer locked instantly
-```
-
-### Unit Conversions
-```
-Reading recipe → Alt+Space → "2 cups to ml" → Enter
-Result: 473.18 ml
-```
-
----
-
-## 🤝 Community Feedback
-
-This feature was inspired by your request! Keep the feedback coming:
-- 🐛 Report bugs
-- 💡 Suggest features
-- ⭐ Star the repo
-- 🤝 Contribute code
-
----
-
-## 📈 What's Next?
-
-We're listening to the community! Vote on features:
-1. Custom themes?
-2. Plugin system?
-3. File search integration?
-4. Web search integration?
-
-[Open an issue](https://github.com/Maniredii/mani-calc/issues) to vote!
-
----
-
-## 🎉 Thank You!
-
-Thank you for using Mani-Calc and providing feedback. This overlay mode makes Windows productivity even better!
-
-**Enjoy your new floating calculator!** ⚡
-
----
-
-**Version**: 1.1.0  
-**Release Date**: January 21, 2026  
-**Major Features**: Overlay Mode, System Commands, Live Preview