nexforge-cli 1.1.1 → 1.1.3

package/README.md

@@ -1,222 +1,204 @@
-# NexForge CLI 🚀
+<div align="center">
+  
+  # 🚀 NexForge CLI
+  
+  **The ultimate Command Line Interface for NexForge — Your Custom PaaS.**
+  
+  [![npm version](https://img.shields.io/npm/v/nexforge-cli.svg?style=flat-square)](https://www.npmjs.com/package/nexforge-cli)
+  [![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg?style=flat-square)](https://opensource.org/licenses/ISC)
+  [![Platform](https://img.shields.io/badge/Platform-NexForge-black?style=flat-square)](https://nexforge-sandy.vercel.app/)
 
-The official Command Line Interface for **NexForge** - Your custom Platform as a Service (PaaS).
-Deploy, manage, and scale your applications directly from your terminal with zero friction!
-<a href="https://nexforge-sandy.vercel.app/">Visit Nexforge</a>
+  Deploy, manage, and scale your applications directly from your terminal with zero friction.
 
----
-### 🌟 Special Feature: Project Folder Structure Generator
-Try **`nexforge create`** to instantly scaffold Fullstack, React, Next.js, Vue, MongoDB, MySQL, and Postgres projects! It features an interactive UI and a **Zero-Bloat Dependency Selection** system that injects only the packages you want (Redux, GSAP, AI SDKs) for lightning-fast setups!
+  [Visit NexForge](https://nexforge-sandy.vercel.app/) • [Report Bug](mailto:manavsharma3825@gmail.com)
+
+</div>
 
-*(💡 **Note:** `nexforge create` is a standalone tool. You can use it to generate projects instantly without needing to log in with GitHub or connect to a NexForge account!)*
 ---
 
-## Installation
+## ⚡ Quick Start
 
-You can install the CLI globally via NPM:
+Install the NexForge CLI globally to access it from anywhere on your system:
 
 ```bash
 npm install -g nexforge-cli
 ```
 
-## Available Commands
+Once installed, you can instantly scaffold a new project or log in to manage existing ones!
 
-Here is the complete list of commands available in the NexForge CLI:
+---
 
-### 🔐 1. `nexforge login`
+## 🛤️ End-to-End Workflow (Step-by-Step)
 
-**Description:** Authenticate your local machine with your NexForge account.
-**Usage:**
+Here is exactly how you go from an empty folder to a live, deployed application on NexForge:
 
-```bash
-nexforge login
-```
+**1️⃣ Create a Project** *(Optional but recommended)*  
+Run `nexforge create` to instantly scaffold a pre-configured React/Next/Vue or Backend project without any bloat.
+
+**2️⃣ Login to NexForge**  
+Run `nexforge login` in your terminal. You'll need your **CLI Token** and **Project ID** from your NexForge web dashboard.
 
-**Details:**
+**3️⃣ Initialize the Project**  
+Navigate into your project folder and run `nexforge init`. This links your local directory to your NexForge servers.
 
-- Prompts you for your personal **CLI Token** (which you can generate from your NexForge Dashboard Settings).
-- Prompts you for your **Project ID**.
-- Saves your credentials securely in `~/.nexforge/config.json`.
+**4️⃣ Deploy to the World! 🚀**  
+Run `nexforge deploy`. The CLI will zip your code, upload it, and stream live build logs directly in your terminal. Once done, it gives you a live URL!
 
 ---
 
-### ✨ 2. `nexforge init`
+## 🌟 The Ultimate Project Generator: `nexforge create`
 
-**Description:** Initialize a new NexForge project right from your terminal without opening the browser.
-**Usage:**
+**Say goodbye to bloated boilerplate.** `nexforge create` is a standalone project generator that instantly scaffolds Fullstack, React, Next.js, Vue, and backend templates (MongoDB, PostgreSQL, MySQL). 
+
+It features an interactive UI and a **Zero-Bloat Dependency System** that injects *only* the packages you explicitly request (like Redux, GSAP, or AI SDKs) for lightning-fast setups.
 
 ```bash
-nexforge init
+nexforge create
 ```
 
-**Details:**
+**How it works:**
 
-- Asks for your **Project Name**.
-- Asks for the **Framework** you are using (e.g., React, Vue, Express, Node.js).
-- Automatically registers the project on NexForge servers and links your current directory to the new Project ID.
+**1️⃣ Interactive UI**  
+Run the command and enter your project name.
 
----
+**2️⃣ Choose your Stack**  
+Select Fullstack, Frontend Only, or Backend Only.
 
-### 🏗️ 3. `nexforge create`
+**3️⃣ Pick your Framework**  
+Next.js, React, Vue, or Express with your database of choice.
 
-**Description:** The ultimate project generator. Scaffold a fully configured project (React, Next.js, Vue, MERN, Postgres, MySQL) with an interactive UI, blazing fast copy, and **Zero Bloat** dependency selection!
-**Usage:**
+**4️⃣ Zero-Bloat Selection**  
+Choose add-ons like Animations (GSAP/Framer), State Management (Redux), or AI SDKs (OpenAI/Groq).
 
-```bash
-nexforge create
-```
+**5️⃣ Ready to Go**  
+The CLI installs everything. Just `cd` into your directory, run `nexforge init`, and deploy!
 
-**How it works (Step-by-Step):**
+### 📂 Generated Folder Structures
 
-1. **Run the Command:** Type `nexforge create` in your terminal. You'll be greeted by a beautiful, interactive CLI.
-2. **Project Name:** Enter a name for your new app.
-3. **Select your Stack:** Choose from 3 primary modes:
-   - **Fullstack:** Automatically generates a combined frontend + backend repository.
-   - **Frontend Only:** Choose between **React + Vite**, **Next.js**, or **Vue + Vite**.
-   - **Backend Only:** Choose between **Express + MongoDB**, **Express + PostgreSQL**, or **Express + MySQL**.
-4. **Zero-Bloat Dependency Selection:** Instead of downloading a massive, bloated template, the CLI asks you exactly what you need:
-   - *Need Animations?* Select yes to inject GSAP & Framer Motion.
-   - *Need State Management?* Select yes to inject Redux Toolkit.
-   - *Need AI?* Select yes to inject OpenAI & Groq SDKs.
-   - The CLI intelligently injects *only* the packages you selected into your `package.json` for a lightning-fast install.
-5. **Ready to Deploy:** Once finished, simply `cd` into your new folder, run `nexforge init` to connect it to your account, and `nexforge deploy` to take it live!
+Depending on your choice, the CLI organizes your project perfectly:
 
----
+**Fullstack Mode**
+```text
+my-awesome-app/
+├── frontend/       # Your chosen frontend (React / Next.js / Vue)
+└── backend/        # Your chosen backend (Express + DB)
+```
 
-### 🚀 4. `nexforge deploy`
+**Single Stack Mode (Frontend or Backend)**
+```text
+my-awesome-app/
+├── src/            # Source code for your framework
+├── package.json    # Pre-configured scripts & selected deps
+└── ...             # Config files (Tailwind, Vite, etc.)
+```
 
-**Description:** Package and deploy your current directory to NexForge.
-**Usage:**
+### 📦 Available Zero-Bloat Packages
 
-```bash
-nexforge deploy
-```
+The CLI dynamically injects only the packages you approve. Here is exactly what gets installed when you select "Yes":
+
+**Frontend Add-ons:**
+- **Animations:** `framer-motion`, `gsap`, `lenis`
+- **State Management:** `@reduxjs/toolkit`, `react-redux`
+- **Websockets:** `socket.io-client`
+- **UI Extras:** `react-toastify`, `react-icons`, `@heroicons/react`
+- **Charts:** `recharts`
 
-**Details:**
+**Backend Add-ons:**
+- **AI SDKs:** `openai`, `@google/genai`, `groq-sdk`
+- **Redis & Queues:** `redis`, `ioredis`, `bullmq`
+- **S3 Storage:** `@aws-sdk/client-s3`, `multer`
+- **Websockets:** `socket.io`
 
-- Instantly zips your source code (ignoring `node_modules`, `.git`, and `.env`).
-- Uploads the code to NexForge backend servers.
-- Automatically connects to the live **WebSocket log stream** so you can watch your build progress in real-time.
-- Returns your live deployment URL upon success.
+*(💡 **Note:** `nexforge create` works entirely locally. You don't need a NexForge account to use it as an everyday project generator!)*
 
 ---
 
-### 🌐 5. `nexforge env`
+## 🛠️ CLI Command Reference
 
-**Description:** Manage your environment variables securely.
+Manage your NexForge deployments effortlessly. Below is the complete suite of commands available.
 
-#### Push Variables
+### 🔐 Authentication & Setup
 
+**Authenticate your CLI**  
+Prompts for your Personal CLI Token and Project ID, saving credentials securely to `~/.nexforge/config.json`.
 ```bash
-nexforge env push
+nexforge login
 ```
 
-- Reads your local `.env` file and securely pushes all variables to your NexForge project.
-
-#### Pull Variables
-
+**Initialize a new NexForge project**  
+Registers your project on the server without opening a browser.
 ```bash
-nexforge env pull
+nexforge init
 ```
 
-- Fetches all environment variables from your live NexForge project and saves them into a local `.env` file.
+### 🚀 Deployment & Monitoring
 
----
-
-### 📜 6. `nexforge logs`
-
-**Description:** Stream live build and deployment logs for your project.
-**Usage:**
+**Deploy your project**  
+Packages your code (ignoring `node_modules`, `.git`, `.env`), uploads to NexForge, and streams live build logs via WebSocket. Returns a live URL on success.
+```bash
+nexforge deploy
+```
 
+**View live logs**  
+Connects to the WebSocket server and streams real-time logs for any ongoing deployment pipelines.
 ```bash
 nexforge logs
 ```
 
-**Details:**
-
-- Connects to the NexForge WebSocket server and streams real-time logs for any ongoing deployment pipelines.
-
----
-
-### ⏪ 7. `nexforge rollback`
-
-**Description:** Instantly revert your live website to a previous stable deployment.
-**Usage:**
-
+**Rollback deployment**  
+Revert to a previous stable deployment instantly with zero downtime and no rebuild required.
 ```bash
 nexforge rollback
 ```
 
-**Details:**
-
-- Fetches a list of your recent successful and failed deployments.
-- Prompts you to select a version.
-- Instantly updates the symbolic links on the server to serve the older version with **zero downtime** and **no rebuild required**.
-
----
-
-### ✏️ 8. `nexforge rename`
-
-**Description:** Rename the subdomain of your project.
-**Usage:**
+### 🌐 Environment & Domains
 
+**Push local environment variables**  
+Reads your local `.env` file and securely syncs all variables to your live NexForge project.
 ```bash
-nexforge rename
+nexforge env push
 ```
 
-**Details:**
-
-- Asks for your new preferred subdomain.
-- Validates availability on the NexForge servers.
-- Instantly updates your live URL to the new subdomain.
-
----
-
-### ℹ️ 9. `nexforge info`
-
-**Description:** View your current project's status and details.
-**Usage:**
-
+**Pull remote environment variables**  
+Fetches all environment variables from your live NexForge project and saves them into your local `.env` file.
 ```bash
-nexforge info
+nexforge env pull
 ```
 
-**Details:**
-
-- Fetches and displays your project name, framework, custom domains, live URL, and latest deployment status directly in the terminal.
-
----
-
-### 🌐 10. `nexforge domains`
-
-**Description:** Manage custom domains for your project.
-**Usage:**
+**Add a custom domain**  
+Links a new custom domain to your project directly from the terminal.
+```bash
+nexforge domains add <domain>
+```
 
+**List custom domains**  
+Lists all custom domains currently linked to your active project.
 ```bash
-nexforge domains add <your-domain.com>
 nexforge domains ls
 ```
 
-**Details:**
-
-- `add`: Links a new custom domain to your project without opening the dashboard.
-- `ls`: Lists all custom domains currently linked to your project.
-
----
+### ℹ️ Utility Commands
 
-### 🌍 11. `nexforge open`
+**View project info**  
+View project status, framework, custom domains, live URL, and recent deployment status.
+```bash
+nexforge info
+```
 
-**Description:** Opens your live project in your default web browser.
-**Usage:**
+**Rename project**  
+Change your project's subdomain instantly. Validates availability and updates your live URL.
+```bash
+nexforge rename
+```
 
+**Open live project**  
+Instantly opens your live project URL in your default web browser.
 ```bash
 nexforge open
 ```
 
-**Details:**
-
-- Fetches your project's live URL and instantly opens it in your host OS browser.
-
 ---
 
-### Built With ❤️ by Manav Sharma
+<div align="center">
+  <b>Built with ❤️ by Manav Sharma</b>
+</div>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexforge-cli",
-  "version": "1.1.1",
+  "version": "1.1.3",
   "description": "Custom Deployment CLI for NexForge",
   "main": "index.js",
   "bin": {

package/src/commands/create.js

@@ -150,7 +150,7 @@ export default (program) => {
         if (project.stackType === "fullstack") {
           if (project.frontendFramework === "nextjs") {
             s.message("Bootstrapping Next.js... (this might take a minute)")
-            runCommand(`npx create-next-app@latest ${project.name} --js --tailwind --eslint --app --src-dir --import-alias "@/*"`, process.cwd())
+            runCommand(`npx --yes create-next-app@latest ${project.name} --js --tailwind --eslint --app --src-dir --import-alias "@/*"`, process.cwd())
             injectDependencies(targetDir, "frontend")
             s.message("Installing selected NexForge dependencies for Next.js...")
             runCommand("npm install", targetDir)
@@ -173,7 +173,7 @@ export default (program) => {
         } else if (project.stackType === "frontend") {
           if (project.frontendFramework === "nextjs") {
              s.message("Bootstrapping Next.js... (this might take a minute)")
-             runCommand(`npx create-next-app@latest ${project.name} --js --tailwind --eslint --app --src-dir --import-alias "@/*"`, process.cwd())
+             runCommand(`npx --yes create-next-app@latest ${project.name} --js --tailwind --eslint --app --src-dir --import-alias "@/*"`, process.cwd())
              injectDependencies(targetDir, "frontend")
              s.message("Installing selected NexForge dependencies for Next.js...")
              runCommand("npm install", targetDir)