langctl 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Langctl
+
+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.

package/PUBLISH_GUIDE.md

@@ -0,0 +1,209 @@
+# Publishing Langctl to npm
+
+## 📦 Reserve the `langctl` Package Name
+
+### Prerequisites
+- npm account (create at https://www.npmjs.com/signup)
+- Email verified on npm
+- Two-factor authentication enabled (recommended)
+
+---
+
+## Step-by-Step Publishing Guide
+
+### 1. Login to npm
+
+```bash
+cd /Users/siddharthsaxena/Documents/projects/langctl/langctl-cli
+
+# Login to npm
+npm login
+
+# Enter your credentials:
+# - Username
+# - Password
+# - Email
+# - OTP (if 2FA enabled)
+```
+
+### 2. Check if Name is Available
+
+```bash
+npm search langctl
+```
+
+If nothing shows up, the name is available! ✅
+
+### 3. Test the Package Locally
+
+```bash
+# Make the CLI executable
+chmod +x bin/langctl.js
+chmod +x index.js
+
+# Test it works
+node bin/langctl.js
+```
+
+You should see the "Coming Soon" message.
+
+### 4. Publish to npm
+
+```bash
+# Publish as public package (free)
+npm publish --access public
+```
+
+**Expected output:**
+```
++ langctl@0.0.1
+```
+
+### 5. Verify It's Published
+
+```bash
+# Search for your package
+npm search langctl
+
+# View package page
+npm view langctl
+
+# Visit on web
+# https://www.npmjs.com/package/langctl
+```
+
+### 6. Test Installation
+
+```bash
+# Test installing globally
+npm install -g langctl
+
+# Run it
+langctl
+
+# You should see the "Coming Soon" message
+```
+
+---
+
+## 🎉 Success!
+
+Your package is now published and the name is reserved!
+
+Anyone who tries:
+```bash
+npm install -g langctl
+```
+
+Will get your placeholder package with the "Coming Soon" message.
+
+---
+
+## 📈 Update Version When Ready
+
+When you build the actual CLI:
+
+```bash
+# Update version
+npm version patch  # 0.0.1 -> 0.0.2
+npm version minor  # 0.0.1 -> 0.1.0
+npm version major  # 0.0.1 -> 1.0.0
+
+# Publish update
+npm publish
+```
+
+---
+
+## 🔐 Security Best Practices
+
+### Enable 2FA on npm Account
+```bash
+npm profile enable-2fa auth-and-writes
+```
+
+### Use npm Access Tokens (for CI/CD later)
+```bash
+npm token create --read-only
+```
+
+---
+
+## 📝 Package Details
+
+**Package Name:** `langctl`  
+**Current Version:** `0.0.1`  
+**Type:** Placeholder  
+**License:** MIT  
+**Homepage:** https://langctl.com  
+
+---
+
+## 🚀 Next Steps
+
+1. ✅ Publish placeholder package (reserve name)
+2. 🏗️ Build actual CLI tool
+3. 📦 Update package with real functionality
+4. 🎯 Publish v1.0.0 when ready
+
+---
+
+## ⚠️ Important Notes
+
+- **Placeholder package is intentional** - This reserves the name while you build
+- **Users will see "Coming Soon"** - They know it's in development
+- **npm allows placeholders** - As long as they have valid code
+- **Update regularly** - Update description/readme as you build
+
+---
+
+## 🐛 Troubleshooting
+
+### "Package name already taken"
+```bash
+# Try variations:
+# @your-username/langctl
+# langctl-cli
+# langctl-tool
+```
+
+### "You must verify your email"
+1. Check your email for npm verification link
+2. Click the link
+3. Try publishing again
+
+### "You must sign in to publish"
+```bash
+npm logout
+npm login
+npm publish --access public
+```
+
+### "Package too large"
+```bash
+# Check package size
+npm pack --dry-run
+
+# Should be very small (<10KB for placeholder)
+```
+
+---
+
+## 📧 Support
+
+Questions about npm publishing?
+- npm docs: https://docs.npmjs.com/
+- npm support: support@npmjs.com
+- Langctl: hello@langctl.com
+
+---
+
+**Ready to publish? Just run:**
+
+```bash
+cd /Users/siddharthsaxena/Documents/projects/langctl/langctl-cli
+npm login
+npm publish --access public
+```
+
+That's it! 🚀

package/README.md

@@ -0,0 +1,57 @@
+# Langctl
+
+> CLI-first translation management for developers
+
+🚧 **Coming Soon** - This package is currently in development.
+
+## What is Langctl?
+
+Langctl is a modern translation management tool built for developers who want to:
+- Manage translations from the command line
+- Use AI-powered translations
+- Save money compared to enterprise tools
+- Integrate seamlessly with their development workflow
+
+## Features (Planned)
+
+- 🖥️ **CLI-First** - Manage translations from your terminal
+- 🤖 **AI-Powered** - Context-aware translations using advanced AI
+- 💰 **Affordable** - Starting free, pay only for what you use
+- ⚡ **Fast** - Setup in under 2 minutes
+- 🔧 **Framework Agnostic** - Works with Angular, React, Vue, and more
+
+## Installation (When Available)
+
+```bash
+npm install -g langctl
+```
+
+## Usage (When Available)
+
+```bash
+# Initialize langctl in your project
+langctl init
+
+# Scan for translation keys
+langctl scan
+
+# Translate to multiple languages
+langctl translate --target es,fr,de --ai
+
+# Push to cloud
+langctl push
+```
+
+## Stay Updated
+
+- 🌐 Website: [langctl.com](https://langctl.com)
+- 📧 Email: hello@langctl.com
+- 🐙 GitHub: [github.com/siddharthsaxena0/langctl](https://github.com/siddharthsaxena0/langctl)
+
+## License
+
+MIT © Langctl
+
+---
+
+**Note:** This is a placeholder package to reserve the name. The actual CLI tool is under development and will be released soon.

package/bin/langctl.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+
+console.log(`
+╔══════════════════════════════════════════════════════════╗
+║                                                          ║
+║                      🚧 Coming Soon 🚧                    ║
+║                                                          ║
+║              Langctl CLI is under development            ║
+║                                                          ║
+║  Translation management for developers who code          ║
+║  CLI-first • AI-powered • Affordable                     ║
+║                                                          ║
+║  Learn more: https://langctl.com                         ║
+║  Email: hello@langctl.com                                ║
+║                                                          ║
+╚══════════════════════════════════════════════════════════╝
+`);
+
+process.exit(0);

package/index.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+
+/**
+ * Langctl - CLI-first translation management for developers
+ * 
+ * This is a placeholder package. The full CLI is under development.
+ * Visit https://langctl.com for updates.
+ */
+
+console.log(`
+╔══════════════════════════════════════════════════════════╗
+║                                                          ║
+║                      🚧 Coming Soon 🚧                    ║
+║                                                          ║
+║              Langctl CLI is under development            ║
+║                                                          ║
+║  Translation management for developers who code          ║
+║  CLI-first • AI-powered • Affordable                     ║
+║                                                          ║
+║  Learn more: https://langctl.com                         ║
+║  Email: hello@langctl.com                                ║
+║                                                          ║
+╚══════════════════════════════════════════════════════════╝
+`);
+
+module.exports = {};

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "langctl",
+  "version": "0.0.1",
+  "description": "CLI-first translation management for developers. Affordable, AI-powered, and built for modern workflows.",
+  "main": "index.js",
+  "bin": {
+    "langctl": "./bin/langctl.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "translation",
+    "i18n",
+    "internationalization",
+    "localization",
+    "l10n",
+    "cli",
+    "translations",
+    "translate",
+    "language",
+    "multilingual"
+  ],
+  "author": "Siddharth Saxena <hello@langctl.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/siddharthsaxena0/langctl.git"
+  },
+  "bugs": {
+    "url": "https://github.com/siddharthsaxena0/langctl/issues"
+  },
+  "homepage": "https://langctl.com",
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}