@alevnyacow/nzmt 0.34.3 → 0.35.1

package/README.md

@@ -10,20 +10,52 @@
 
 Scaffold full-stack modules in Next.js in seconds with **Next Zod Modules Toolkit (NZMT)**. 
 
-Get a DDD-inspired architecture with a contract-first approach out of the box. NZMT also comes with useful infrastructure like DI, logging, in-memory stores, unified errors, and endpoint guards. 
+Get a DDD-inspired architecture with a contract-first approach out of the box.
 
 Batteries included! ✨
 
-# TL;DR
 
-Initialize NZMT once, run the scaffolder, and tweak a few files to get a production-ready backend usable via Server Actions with ready-to-use React Query hooks.
+# Try it!
 
-# Playground on Stackblitz
-
-(may not work on Safari)
+(stackblitz may not work on Safari)
 
 https://stackblitz.com/edit/nzmt-playground
 
+# What you get
+
+Get production-ready backend + React Query hooks after one CLI command with NZMT. Install and initialize it, then run:
+ 
+```bash
+npx nzmt crud-api user
+```
+
+This will instantly scaffold:
+
+```bash
+server/
+  entities/user/... # user entity
+  stores/user/... # user stores (contract, in-memory, prisma)
+  services/user/... # service
+  controllers/user/... # API controller
+
+app/api/user/... # api routes
+
+ui/shared/queries/user/... # react queries
+```
+
+Everything is already setup and ready-to-use after a few tweaks. See `Quick start with Prisma` section for more detailed information.
+
+NZMT also comes with useful infrastructure like DI, logging, in-memory stores, unified errors, and endpoint guards. All code is editable, so you stay in full control. Full `crud-api` is only one of cases, you can scaffold entities, stores, services, controllers and infrastructure helpers on its own and combine them any way you want. List of all NZMT cli commands is provided in `CLI commands glossary` sections.
+
+Fully wired flow:
+```bash
+# client fetching
+Client → React Query → API → Controller → Service → Store → DB
+
+# server actions
+Server Action → Service → Store → DB
+```
+
 # Quick start with Prisma
 
 Assuming you have 
@@ -128,7 +160,7 @@ export default async function Page() {
 }
 ```
 
-# Scaffolder commands glossary
+# CLI commands glossary
 
 ## Initialization
 
@@ -296,12 +328,10 @@ A “Repository” is a specific design pattern for managing data. NZMT prefers
 
 `NZMT` combines the best of both worlds in one package while staying in plain Next.js:
 
-- From tRPC — type safety and developer experience
-- From NestJS — structured architecture (but more DDD-inspired) with intuitive DI
-
-Plus:
-
-- No framework lock-in
-- No magic runtime
-- Full control over your code
-- No extra client-server layers
+| Feature           | NZMT | tRPC | Nest |
+| ----------------- | ---- | ---- | ---- |
+| Type safety       | ✅    | ✅    | ⚠️   |
+| Scaffolding       | ✅    | ❌    | ⚠️   |
+| Architecture      | ✅    | ❌    | ✅    |
+| Boilerplate       | Low  | Low  | High |
+| No framework lock-in | ✅    | ✅    | ❌    |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alevnyacow/nzmt",
-  "version": "0.34.3",
+  "version": "0.35.1",
   "description": "Next Zod Modules Toolkit",
   "keywords": ["next", "full-stack", "server", "backend", "cli", "scaffolding", "zod", "rest", "contract programming", "contract-first", "react-query", "ddd", "domain-driven"],
   "repository": {