create-nexo 1.4.0 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +37 -31
  2. package/dist/bin/nexo.js +195 -224
  3. package/package.json +6 -8
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  <div align="center">
2
2
 
3
- # 🚀 NEXO CLI
3
+ # 🚀 NEXO CLI
4
4
  **Next-generation, extensible CLI for scaffolding and orchestrating modern frontend projects**
5
5
 
6
6
  [![npm version](https://img.shields.io/npm/v/create-nexo.svg?style=flat-square&color=cyan)](https://www.npmjs.com/package/create-nexo)
@@ -8,32 +8,36 @@
8
8
  [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg?style=flat-square)](LICENSE)
9
9
  [![Node.js](https://img.shields.io/badge/Node.js-18+-green.svg?style=flat-square)](https://nodejs.org/)
10
10
 
11
- 🌐 **[Official Website](https://nexo-site-ten.vercel.app/)** | 📖 **[Documentation](./docs/cli.md)**
11
+ 🌐 **[Official Website](https://nexo-site-ten.vercel.app/)** | 📖 **[Documentation](./docs/cli.md)**
12
12
 
13
13
  </div>
14
14
 
15
15
  ---
16
16
 
17
- ## � Core Features & Ecosystem
17
+ ## 🎯 Core Features & Ecosystem
18
18
 
19
19
  NEXO combines a cutting-edge tech stack with a powerful orchestration engine for an elite development experience.
20
20
 
21
- - ⚛️ **Modern Foundation** — Native **React 19** support with **React Compiler**, built for speed on the leading **Vite** engine.
22
- - 📝 **TypeScript First** — Strict **TS 5.7+** standards out of the box for ultimate type safety and reliability.
23
- - 🎨 **Visual Excellence** — Premier styling with **Tailwind CSS v4**, Sass, and official **shadcn/ui** and **HeroUI** integrations.
24
- - 🧱 **Scalable Architecture** — Professionally scaffolded **FSD**, **Feature-based**, and **Clean Architecture** patterns.
25
- - 🧠 **AI-Native Context** — Auto-generated `.nexo/ai-context.md` for perfect alignment with modern AI coding agents.
26
- - ⚡ **Instant Setup** — Zero-latency I/O with memory-resident `package.json` management; saved exactly once per project.
27
- - 🚀 **Atomic Orchestration** — Combined Git operations and parallel module loading for lightning-fast command execution.
28
- - 🛠️ **Unified Maintenance** — Total project health, security, and bundle auditing via the single `check` command.
29
- - 👀 **Dry Run Safety** — Preview every file and structural change before they ever touch your disk.
21
+ - ⚛️ **Modern Foundation** — Native **React 19** support with **React Compiler**, built for speed on the leading **Vite** engine.
22
+ - 📜 **TypeScript First** — Strict **TS 5.7+** standards out of the box for ultimate type safety and reliability.
23
+ - 🎨 **Visual Excellence** — Premier styling with **Tailwind CSS v4**, Sass, and official **shadcn/ui** and **HeroUI** integrations.
24
+ - 🧱 **Scalable Architecture** — Professionally scaffolded **FSD**, **Feature-based**, and **Clean Architecture** patterns.
25
+ - 🧠 **AI-Native Context** — Auto-generated `.nexo/ai-context.md` for perfect alignment with modern AI coding agents.
26
+ - ⚡ **Instant Setup** — Zero-latency I/O with memory-resident `package.json` management; saved exactly once per project.
27
+ - 🚀 **Atomic Orchestration** — Combined Git operations and parallel module loading for lightning-fast command execution.
28
+ - 🛠️ **Unified Maintenance** — Total project health, security, and bundle auditing via the single `check` command.
29
+ - 👀 **Dry Run Safety** — Preview every file and structural change before they ever touch your disk.
30
30
  - 📦 **Zero-Dependency Binary** — Entire CLI is bundled into a single file (~226KB) for instant installation and startup.
31
31
  - 🚚 **Multi-PM Support** — Native detection and optimization for **pnpm**, **Bun**, and **Yarn**.
32
- - 🏗️ **Template Cloning** — Lightning-fast scaffolding using **GitHub templates** with `tiged` integration.
32
+ - 🏗️ **Template Cloning** — Lightning-fast scaffolding using **GitHub templates** with `tiged` integration and **3-retry resilience**.
33
+ - 🛡️ **Pre-Write Safety** — Permission checks, disk space validation (100MB+), and Windows **MAX_PATH** protection.
34
+ - 🔄 **Network Resilience** — Exponential backoff retry logic with GitHub rate limit detection and offline error guidance.
35
+ - 🏎️ **Optimized npm** — High-performance `npm` strategy with offline caching and audit bypass for 30% faster installs.
36
+ - 📊 **Auto Version Resolution** — Automatically fetches latest package versions with graceful fallback to stable defaults.
33
37
 
34
38
  ---
35
39
 
36
- ## 📦 Quick Start
40
+ ## 📦 Quick Start
37
41
 
38
42
  ```bash
39
43
  # Recommended (Instant execution)
@@ -49,11 +53,13 @@ nexo create my-app
49
53
 
50
54
  ---
51
55
 
52
- ## 🎯 Command Suite
56
+ ## 🎯 Command Suite
53
57
 
54
58
  | Command | Description |
55
59
  |---------|-------------|
56
60
  | `nexo create` | Start a new project with interactive prompts |
61
+ | `nexo create --audit` | Enable security audit during installation |
62
+ | `nexo create --strict` | Enable strict dependency resolution |
57
63
  | `nexo create --template` | Clone a project from a GitHub template |
58
64
  | `nexo wizard` | Guided project creation for beginners |
59
65
  | `nexo presets` | List and use optimized project presets |
@@ -62,26 +68,26 @@ nexo create my-app
62
68
 
63
69
  ---
64
70
 
65
- ## 🎨 Tech Stack Ecosystem
71
+ ## 🎨 Tech Stack Ecosystem
66
72
 
67
73
  ### Build Variants
68
- - **React 19 + Compiler** — The future of React with auto-memoization.
69
- - **TypeScript + Vite** — Industry standard for speed and safety.
70
- - **SWC Transformation** — Ultra-fast builds for massive projects.
74
+ - **React 19 + Compiler** — The future of React with auto-memoization.
75
+ - **TypeScript + Vite** — Industry standard for speed and safety.
76
+ - **SWC Transformation** — Ultra-fast builds for massive projects.
71
77
 
72
78
  ### Styling & UI
73
- - **Tailwind CSS v4** — Utility-first with the latest engine features.
74
- - **shadcn/ui** — Beautiful, accessible, and fully customizable.
75
- - **HeroUI** — Feature-rich component libraries.
79
+ - **Tailwind CSS v4** — Utility-first with the latest engine features.
80
+ - **shadcn/ui** — Beautiful, accessible, and fully customizable.
81
+ - **HeroUI** — Feature-rich component libraries.
76
82
 
77
83
  ### State & Data
78
- - **Zustand / Redux Toolkit** — Scalable state management.
79
- - **TanStack Query** — Advanced caching and data synchronization.
80
- - **TanStack Router / React Router** — Type-safe navigation.
84
+ - **Zustand / Redux Toolkit** — Scalable state management.
85
+ - **TanStack Query** — Advanced caching and data synchronization.
86
+ - **TanStack Router / React Router** — Type-safe navigation.
81
87
 
82
88
  ---
83
89
 
84
- ## 🧠 AI Integration
90
+ ## 🧠 AI Integration
85
91
 
86
92
  Nexo is designed for the age of AI. Every project includes:
87
93
  - **`.nexo/ai-context.md`**: A comprehensive source of truth for your stack, used by LLMs to provide more accurate code.
@@ -89,7 +95,7 @@ Nexo is designed for the age of AI. Every project includes:
89
95
  - **Architecture Context**: Explains project structure and patterns to AI agents for perfect code generation.
90
96
  ---
91
97
 
92
- ## 🔧 Development & Contribution
98
+ ## 🛠️ Development & Contribution
93
99
 
94
100
  ```bash
95
101
  git clone https://github.com/Moshaban09/create-nexo.git
@@ -101,16 +107,16 @@ npm link
101
107
 
102
108
  ---
103
109
 
104
- ## 📄 License
110
+ ## 📄 License
105
111
 
106
- MIT © 2026 **Mohamed Shaban**
112
+ MIT © 2026 **Mohamed Shaban**
107
113
 
108
114
  ---
109
115
 
110
116
  <div align="center">
111
117
 
112
- **Built with ❤️ for the modern web**
118
+ **Built with ❤️ for the modern web**
113
119
 
114
- [Report Bug](https://github.com/Moshaban09/create-nexo/issues) • [Request Feature](https://github.com/Moshaban09/create-nexo/issues)
120
+ [Report Bug](https://github.com/Moshaban09/create-nexo/issues) • [Request Feature](https://github.com/Moshaban09/create-nexo/issues)
115
121
 
116
122
  </div>