neex 0.7.3 → 0.7.5

package/README.md

@@ -7,7 +7,7 @@
 </picture>
 </a>
 
-# Neex v0.7.3
+# Neex v0.7.5
 
 ### Neex - Modern Fullstack Framework Built on Express and Next.js. Fast to Start, Easy to Build, Ready to Deploy.
 
@@ -158,25 +158,6 @@ neex start dist/server.js --health-port 3001
 ```
 
 
-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 && bun run dev",
-    "dev:server": "cd apps/server && bun run dev",
-    "build": "neex s prisma:generate prisma:migrate build:client build:server",
-    "build:client": "cd apps/client && bun run build",
-    "build:server": "cd apps/server && bun run build",
-    "start": "neex p start:client start:server",
-    "start:client": "cd apps/client && bun run start",
-    "start:server": "cd apps/server && bun run start",
-    "prisma:generate": "cd apps/server && bunx prisma generate",
-    "prisma:migrate": "cd apps/server && bunx prisma db push"
-  }
-}
-```
 
 ### Explanation of Scripts
 
@@ -200,26 +181,6 @@ npm run build        # Sequentially generates Prisma client, applies migrations,
 npm run start        # Starts frontend and backend in production mode concurrently
 ```
 
-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. 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 && bun run dev",
-    "dev:server": "cd apps/server && bun run dev",
-    "build": "neex s prisma:generate prisma:migrate build:client build:server",
-    "build:client": "cd apps/client && bun run build",
-    "build:server": "cd apps/server && bun run build",
-    "start": "neex p start:client start:server",
-    "start:client": "cd apps/client && bun run start",
-    "start:server": "cd apps/server && bun run start",
-    "prisma:generate": "cd apps/server && bunx prisma generate",
-    "prisma:migrate": "cd apps/server && bunx prisma db push"
-  }
-}
-```
-
 
 #### Parallel and Sequential Execution
 
@@ -236,6 +197,8 @@ neex s "npm run clean" "npm run build" "npm run deploy"
 neex p -q "npm run step1" "npm run step2"
 ```
 
+
+
 ## 📂 Project Structure
 
 Neex creates a polyrepo-in-monorepo structure for clear separation and scalability:
@@ -319,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
 {
@@ -334,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
+
+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.3",
+  "version": "0.7.5",
   "description": "The Modern Build System for Polyrepo-in-Monorepo Architecture",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",