neex 0.7.4 → 0.7.6

package/README.md

@@ -7,7 +7,7 @@
 </picture>
 </a>
 
-# Neex v0.7.4
+# Neex v0.7.6
 
 ### Neex - Modern Fullstack Framework Built on Express and Next.js. Fast to Start, Easy to Build, Ready to Deploy.
 
@@ -199,28 +199,6 @@ neex p -q "npm run step1" "npm run step2"
 
 
 
-Below is an example of `package.json` scripts for running two projects (frontend and backend) concurrently, along with ORM (Prisma) integration, tailored for a Neex project with a polyrepo-in-monorepo architecture. This example demonstrates how to use Neex commands to manage development, building, and production workflows efficiently.
-
-```json
-{
-  "scripts": {
-    "dev": "neex p dev:client dev:server",
-    "dev:client": "cd apps/client && npm run dev",
-    "dev:server": "cd apps/server && npm run dev",
-    "build": "neex s prisma:generate prisma:migrate build:client build:server",
-    "build:client": "cd apps/client && npm run build",
-    "build:server": "cd apps/server && npm run build",
-    "start": "neex p start:client start:server",
-    "start:client": "cd apps/client && npm run start",
-    "start:server": "cd apps/server && npm run start",
-    "prisma:generate": "cd apps/server && npx prisma generate",
-    "prisma:migrate": "cd apps/server && npx prisma db push"
-  }
-}
-```
-
-
-
 ## 📂 Project Structure
 
 Neex creates a polyrepo-in-monorepo structure for clear separation and scalability:
@@ -304,10 +282,13 @@ neex start dist/server.js --max-memory 1G
 
 
 
-
 ## 💡 Real-World Scenarios
 
-Integrate Neex into your `package.json` for a seamless workflow:
+Integrate Neex into your `package.json` to streamline development, building, and deployment workflows for your fullstack projects. Whether you're working with an **Express-only backend** or a combined **Express + Next.js** application, Neex’s powerful CLI and monorepo architecture make it easy to manage your projects efficiently.
+
+### Example 1: Express-Only Project
+
+For a standalone Express backend, configure your `package.json` with minimal yet powerful scripts to handle development, building, and production:
 
 ```json
 {
@@ -319,15 +300,57 @@ Integrate Neex into your `package.json` for a seamless workflow:
 }
 ```
 
-Run scripts with:
+**Run your scripts**:
+
+```bash
+npm run dev    # Starts the Express development server with live-reloading
+npm run build  # Compiles TypeScript to production-ready JavaScript
+npm run start  # Launches the Express server in production mode
+```
+
+This setup provides a clean, efficient workflow for Express-based projects, leveraging Neex’s live-reloading and production-ready features for rapid development and deployment.
+
+### Example 2: Fullstack Express + Next.js Project => Neex
+
+For a fullstack application with a **Next.js frontend** and an **Express backend**, Neex’s polyrepo-in-monorepo architecture shines. The following `package.json` example demonstrates how to manage both projects concurrently, with integrated Prisma ORM for database operations:
+
+```json
+{
+  "scripts": {
+    "dev": "neex p dev:client dev:server",
+    "dev:client": "cd apps/client && npm run dev",
+    "dev:server": "cd apps/server && npm run dev",
+    "build": "neex s prisma:generate prisma:migrate build:client build:server",
+    "build:client": "cd apps/client && npm run build",
+    "build:server": "cd apps/server && npm run build",
+    "start": "neex p start:client start:server",
+    "start:client": "cd apps/client && npm run start",
+    "start:server": "cd apps/server && npm run start",
+    "prisma:generate": "cd apps/server && npx prisma generate",
+    "prisma:migrate": "cd apps/server && npx prisma db push"
+  }
+}
+```
+
+**Run your scripts**:
 
 ```bash
-npm run dev    # Start development server with live-reloading
-npm run build  # Compile TypeScript project for production
-npm run start  # Start production server
+npm run dev    # Starts Next.js frontend and Express backend in parallel with live-reloading
+npm run build  # Sequentially generates Prisma client, applies migrations, and builds both projects
+npm run start  # Launches frontend and backend in production mode concurrently
 ```
 
-This configuration provides a minimal yet effective setup for developing, building, and deploying your Neex project. The `dev` command runs a TypeScript development server, `build` compiles the project, and `start` launches the production application.
+### Why It Works
+
+- **Parallel Execution**: Use `neex p` to run frontend and backend tasks simultaneously, ensuring efficient development and production workflows.
+- **Sequential Execution**: Use `neex s` for tasks like Prisma migrations and builds, ensuring dependencies are handled in the correct order.
+- **Modular Architecture**: Neex’s polyrepo-in-monorepo structure keeps frontend and backend codebases independent yet unified, making it easy to scale or extract projects.
+- **Prisma Integration**: Streamlined database management with `prisma:generate` and `prisma:migrate` for type-safe, rapid development.
+
+This configuration is perfect for developers building fullstack applications with **Next.js**, **Express**, and **Prisma**, offering a seamless, scalable, and maintainable development experience. Start using Neex today to simplify your workflow and build high-performance applications with ease!
+
+
+
 
 ## 📋 System Requirements
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neex",
-  "version": "0.7.4",
+  "version": "0.7.6",
   "description": "The Modern Build System for Polyrepo-in-Monorepo Architecture",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
@@ -60,7 +60,7 @@
     "typescript": "^4.9.3"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=18.0.0"
   },
   "repository": {
     "type": "git",