nexforge-cli 1.1.1 → 1.1.2

package/README.md

@@ -1,222 +1,143 @@
-# 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!
-
-*(💡 **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
-
-You can install the CLI globally via NPM:
-
-```bash
-npm install -g nexforge-cli
-```
+  [Visit NexForge](https://nexforge-sandy.vercel.app/) • [Report Bug](https://github.com/manavsharma111/nexforge/issues)
 
-## Available Commands
-
-Here is the complete list of commands available in the NexForge CLI:
-
-### 🔐 1. `nexforge login`
-
-**Description:** Authenticate your local machine with your NexForge account.
-**Usage:**
-
-```bash
-nexforge login
-```
-
-**Details:**
-
-- 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`.
+</div>
 
 ---
 
-### ✨ 2. `nexforge init`
+## ⚡ Quick Start
 
-**Description:** Initialize a new NexForge project right from your terminal without opening the browser.
-**Usage:**
+Install the NexForge CLI globally to access it from anywhere on your system:
 
 ```bash
-nexforge init
-```
-
-**Details:**
-
-- 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.
-
----
-
-### 🏗️ 3. `nexforge create`
-
-**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:**
-
-```bash
-nexforge create
+npm install -g nexforge-cli
 ```
 
-**How it works (Step-by-Step):**
-
-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!
+Once installed, you can instantly scaffold a new project or log in to manage existing ones!
 
 ---
 
-### 🚀 4. `nexforge deploy`
-
-**Description:** Package and deploy your current directory to NexForge.
-**Usage:**
-
-```bash
-nexforge deploy
-```
+## 🛤️ End-to-End Workflow (Step-by-Step)
 
-**Details:**
+Here is exactly how you go from an empty folder to a live, deployed application on NexForge:
 
-- 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.
+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.
+3. **Initialize the Project**:
+   Navigate into your project folder and run `nexforge init`. This links your local directory to your NexForge servers.
+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!
 
 ---
 
-### 🌐 5. `nexforge env`
+## 🌟 The Ultimate Project Generator: `nexforge create`
 
-**Description:** Manage your environment variables securely.
+**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). 
 
-#### Push Variables
+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 env push
-```
-
-- Reads your local `.env` file and securely pushes all variables to your NexForge project.
-
-#### Pull Variables
-
-```bash
-nexforge env pull
-```
-
-- Fetches all environment variables from your live NexForge project and saves them into a local `.env` file.
-
----
-
-### 📜 6. `nexforge logs`
-
-**Description:** Stream live build and deployment logs for your project.
-**Usage:**
-
-```bash
-nexforge logs
+nexforge create
 ```
 
-**Details:**
-
-- Connects to the NexForge WebSocket server and streams real-time logs for any ongoing deployment pipelines.
-
----
+**How it works:**
+1. **Interactive UI**: Run the command and enter your project name.
+2. **Choose your Stack**: Select Fullstack, Frontend Only, or Backend Only.
+3. **Pick your Framework**: Next.js, React, Vue, or Express with your database of choice.
+4. **Zero-Bloat Selection**: Choose add-ons like Animations (GSAP/Framer), State Management (Redux), or AI SDKs (OpenAI/Groq).
+5. **Ready to Go**: The CLI installs everything. Just `cd` into your directory, run `nexforge init`, and deploy!
 
-### ⏪ 7. `nexforge rollback`
+### 📂 Generated Folder Structures
 
-**Description:** Instantly revert your live website to a previous stable deployment.
-**Usage:**
+Depending on your choice, the CLI organizes your project perfectly:
 
-```bash
-nexforge rollback
+**Fullstack Mode**
+```text
+my-awesome-app/
+├── frontend/       # Your chosen frontend (React / Next.js / Vue)
+└── backend/        # Your chosen backend (Express + DB)
 ```
 
-**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:**
-
-```bash
-nexforge rename
+**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.)
 ```
 
-**Details:**
+### 📦 Available Zero-Bloat Packages
 
-- Asks for your new preferred subdomain.
-- Validates availability on the NexForge servers.
-- Instantly updates your live URL to the new subdomain.
+The CLI dynamically injects only the packages you approve. Here is exactly what gets installed when you select "Yes":
 
----
-
-### ℹ️ 9. `nexforge info`
+**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`
 
-**Description:** View your current project's status and details.
-**Usage:**
+**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`
 
-```bash
-nexforge info
-```
-
-**Details:**
-
-- Fetches and displays your project name, framework, custom domains, live URL, and latest deployment status directly in the terminal.
+*(💡 **Note:** `nexforge create` works entirely locally. You don't need a NexForge account to use it as an everyday project generator!)*
 
 ---
 
-### 🌐 10. `nexforge domains`
+## 🛠️ CLI Command Reference
 
-**Description:** Manage custom domains for your project.
-**Usage:**
-
-```bash
-nexforge domains add <your-domain.com>
-nexforge domains ls
-```
+Manage your NexForge deployments effortlessly. Below is the complete suite of commands available.
 
-**Details:**
+### 🔐 Authentication & Setup
 
-- `add`: Links a new custom domain to your project without opening the dashboard.
-- `ls`: Lists all custom domains currently linked to your project.
+| Command | Description |
+|---------|-------------|
+| **`nexforge login`** | Authenticate your CLI. Prompts for your Personal CLI Token and Project ID, saving credentials securely to `~/.nexforge/config.json`. |
+| **`nexforge init`** | Initialize a new NexForge project in the current directory. Registers your project on the server without opening a browser. |
 
----
+### 🚀 Deployment & Monitoring
 
-### 🌍 11. `nexforge open`
+| Command | Description |
+|---------|-------------|
+| **`nexforge deploy`** | Packages your code (ignoring `node_modules`, `.git`, `.env`), uploads to NexForge, and streams live build logs via WebSocket. Returns a live URL on success. |
+| **`nexforge logs`** | Connects to the WebSocket server and streams real-time logs for any ongoing deployment pipelines. |
+| **`nexforge rollback`** | Revert to a previous stable deployment instantly with zero downtime and no rebuild required. |
 
-**Description:** Opens your live project in your default web browser.
-**Usage:**
+### 🌐 Environment & Domains
 
-```bash
-nexforge open
-```
+| Command | Description |
+|---------|-------------|
+| **`nexforge env push`** | Reads your local `.env` file and securely syncs all variables to your live NexForge project. |
+| **`nexforge env pull`** | Fetches all environment variables from your live NexForge project and saves them into your local `.env` file. |
+| **`nexforge domains add <domain>`** | Links a new custom domain to your project directly from the terminal. |
+| **`nexforge domains ls`** | Lists all custom domains currently linked to your active project. |
 
-**Details:**
+### ℹ️ Utility Commands
 
-- Fetches your project's live URL and instantly opens it in your host OS browser.
+| Command | Description |
+|---------|-------------|
+| **`nexforge info`** | View project status, framework, custom domains, live URL, and recent deployment status. |
+| **`nexforge rename`** | Change your project's subdomain instantly. Validates availability and updates your live URL. |
+| **`nexforge open`** | Instantly opens your live project URL in your default web 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.2",
   "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)