create-nexwire 4.0.0

package/README.md

@@ -0,0 +1,233 @@
+<p align="center">
+  <a href="https://github.com/niyamulahsan/nexwire">
+    <img alt="nexwire" src="https://raw.githubusercontent.com/niyamulahsan/nexwire/main/logo-favicon/nexwire.png" width="300">
+  </a>
+</p>
+
+<h3 align="center">Stop wiring the stack together. Ship the app.</h3>
+
+<p align="center">
+  <a href="https://niyamulahsan.github.io/nexwire"><img src="https://img.shields.io/badge/docs-3b8eed" alt="Documentation"></a>
+  <a href="https://www.npmjs.com/package/create-nexwire"><img src="https://img.shields.io/npm/v/create-nexwire" alt="npm version"></a>
+  <a href="https://github.com/niyamulahsan/nexwire/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="MIT License"></a>
+</p>
+
+---
+
+Every serious TypeScript app needs the same ten things: an HTTP API, auth with refresh-token rotation, a database with migrations, background jobs, real-time sockets, cron, file uploads, email, security headers, and a frontend. Assembling them is a week of glue code — and the failures are the silent kind, where a job never runs or a socket never joins a room.
+
+nexwire ships that stack **already connected**. Auth reads the database. Enqueueing a job is one call. Events broadcast to the right rooms. Uploads land on disk or in S3. `maker` supervises the API, worker, and cron, and Docker Compose puts the whole thing behind nginx with automatic SSL.
+
+- **Runnable the second it exists** — the scaffold ships a pre-migrated, pre-seeded SQLite database, so `npm install && npm run maker dev` lands you on a login screen that already works. Sign in with `admin@example.com` / `Password@123`. No Docker, no Postgres, no services to configure.
+- **Nothing to register** — `maker module:make blog` scaffolds the whole module (routes, controllers, models, seeders, jobs, tests) and the app auto-discovers it. No router file to edit, no registry to update.
+- **One import for every subsystem** — `db`, `cache`, `queue`, `jwt`, `mail`, `storage`, `notify`, and `urls` all come from `@/framework/facade.js`. Drop Redis in dev and the in-memory fallback takes over without touching a single call site.
+- **Infrastructure is optional** — Redis, mail, and S3 sit behind circuit breakers with real fallbacks, so nothing hard-fails when a service is absent or down.
+- **Deploy to a VPS over SSH** — one-time `maker deploy:init`, then `maker deploy:workflow:remote` builds the image, provisions nginx, requests Let's Encrypt certificates, and supervises API, worker, and cron as long-running processes.
+
+## Quick Start
+
+### Hono (default)
+
+```bash
+npm create nexwire@latest my-app
+cd my-app
+npm install
+npm run maker dev
+```
+
+### Express
+
+```bash
+npm create nexwire@latest my-app -- --engine=express
+cd my-app
+npm install
+npm run maker dev
+```
+
+Your API is live at `http://localhost:3000`, Scalar docs at `/api-docs`, and the Vue frontend at `http://localhost:5173`.
+
+The scaffold already ships a pre-migrated, pre-seeded SQLite database, so there is no migration step before `maker dev`. If you point `DATABASE_URL` at MySQL or PostgreSQL, run `npm run maker db:migrate -- --seed` once to build and populate that database instead.
+
+Requires **Node.js >= 22.12** or **Bun >= 1.3**.
+
+### Current directory
+
+Scaffold directly into the current directory:
+
+```bash
+npm create nexwire@latest .
+npm create nexwire@latest . -- --engine=express
+```
+
+Works with any package manager: `pnpm`, `yarn`, or `bun`.
+
+### Package Manager
+
+All examples use `npm` as the default. nexwire works with any major package manager:
+
+| Manager  | Create project                      | Run commands          |
+| -------- | ----------------------------------- | --------------------- |
+| **npm**  | `npm create nexwire@latest my-app`  | `npm run maker <cmd>` |
+| **pnpm** | `pnpm create nexwire@latest my-app` | `pnpm maker <cmd>`    |
+| **yarn** | `yarn create nexwire@latest my-app` | `yarn maker <cmd>`    |
+| **bun**  | `bun create nexwire@latest my-app`  | `bun maker <cmd>`     |
+| **all**  | `npm create nexwire@latest .`       | current directory     |
+
+### Runtime
+
+nexwire runs on **Node.js** or **Bun** — pick whichever fits your deployment:
+
+| Runtime     | Minimum version | Notes                                                                 |
+| ----------- | --------------- | --------------------------------------------------------------------- |
+| **Node.js** | `>= 22.12`      | Default. Uses `node` in Dockerfile.                                   |
+| **Bun**     | `>= 1.3`        | Pass `--runtime=bun` to `deploy:init`. Uses `oven/bun` in Dockerfile. |
+
+## Demo
+
+Real recordings from a freshly scaffolded project — no mockups, no staging data.
+
+**Dev mode** — one command boots the API, Vue UI, Scalar docs, Bull Board queues, MailDev and Redis UI together:
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/niyamulahsan/nexwire/main/packages/docs/public/screenshots/dev-mode.gif" alt="nexwire dev mode: API, UI, API docs, queue dashboard and mail UI booting in one command" width="100%">
+</p>
+
+**Real deploy** — the same project running on a live server, with HTTPS, process supervision and zero-downtime restarts:
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/niyamulahsan/nexwire/main/packages/docs/public/screenshots/real-deploy.gif" alt="nexwire deployed to a real server with HTTPS and process supervision" width="100%">
+</p>
+
+## Features
+
+| Category            | What you get                                                                                                                                  |
+| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
+| **API**             | Hono/Express HTTP server with Zod validation, OpenAPI/Scalar docs, CORS, rate limiting                                                        |
+| **Database**        | Drizzle ORM — SQLite by default, shipped pre-migrated and seeded; MySQL/PostgreSQL also supported, dialect auto-detected from `DATABASE_URL`. |
+| **Auth**            | JWT access + refresh token rotation, signed httpOnly cookies, role middleware                                                                 |
+| **Queue**           | BullMQ background jobs with `shouldQueue` decorator and Bull Board dashboard                                                                  |
+| **Realtime**        | Socket.IO with auto room joining (user, role, auth) and broadcast events                                                                      |
+| **Cache & Session** | Redis-backed with graceful fallback when Redis is disabled                                                                                    |
+| **Scheduler**       | Cron-based task scheduling with distributed Redis lock                                                                                        |
+| **Storage**         | Local disk or S3-compatible (AWS S3, R2, MinIO, DigitalOcean Spaces)                                                                          |
+| **Notifications**   | Database-persisted notifications with broadcast + mail delivery                                                                               |
+| **Frontend**        | Vue 3 SPA — Vite, Pinia, Vue Router, Bootstrap 5, real-time Pulse plugin                                                                      |
+| **Security**        | CSP, HSTS, X-Frame headers — configured in one place, toggled per environment                                                                 |
+| **Reliability**     | Circuit breakers for Redis, mail, and S3 with auto-fallback; startup config validation                                                        |
+| **CLI**             | `maker` command for code generation, migrations, runtime, and deploy                                                                          |
+| **Deploy**          | Two-layer Docker Compose — nginx-proxy, auto SSL, supervisor                                                                                  |
+
+## Architecture
+
+```
+src/
+├── env.ts              # Zod-validated environment config
+├── database/           # Drizzle schema, migrations, seeders
+├── framework/          # Reusable engine (HTTP, auth, queue, cache, etc.)
+├── modules/            # Application modules (auto-discovered)
+├── middlewares/        # Auth & role guards
+├── resources/          # Vue 3 SPA frontend
+└── storage/            # Uploaded files & logs
+```
+
+### Modules
+
+Every feature is a self-contained module under `src/modules/<name>/`:
+
+```
+src/modules/posts/
+├── console/           # CLI commands & scheduled tasks
+├── controllers/       # Request handlers + Zod schemas
+├── database/
+│   ├── models/        # Drizzle table definitions
+│   └── seeders/       # Test data generators
+├── jobs/              # BullMQ queue handlers
+├── routes/            # HTTP route definitions (auto-discovered)
+└── __test__/          # Unit test
+```
+
+Modules are **auto-discovered** — no manual registration. Create one with:
+
+```bash
+npm run maker module:make blog
+npm run maker module:make-controller blog post
+npm run maker module:make-route blog post
+npm run maker module:make-model blog post
+```
+
+### Framework Facade
+
+Access all subsystems through a single import:
+
+```ts
+import {
+  db,
+  cache,
+  session,
+  queue,
+  dispatchEvent,
+  notify,
+  storage,
+  jwt,
+  mail,
+  password,
+  urls,
+  logger,
+} from "@/framework/facade.js";
+```
+
+## CLI Reference
+
+| Command                        | Description                                    |
+| ------------------------------ | ---------------------------------------------- |
+| `maker dev`                    | Start API server + frontend HMR + queue worker |
+| `maker serve [--prod]`         | API server (dev or production)                 |
+| `maker queue:work`             | BullMQ worker process                          |
+| `maker schedule:work`          | Cron scheduler                                 |
+| `maker db:migrate --seed`      | Run migrations + seeders                       |
+| `maker db:fresh`               | Drop all tables, re-migrate, re-seed           |
+| `maker module:make <name>`     | Scaffold a new module                          |
+| `maker deploy:init`            | Generate Docker deploy scaffolding             |
+| `maker deploy:workflow`        | Local deploy (Docker Desktop)                  |
+| `maker deploy:workflow:remote` | Remote deploy via SSH + rsync                  |
+
+## Deployment
+
+nexwire includes a complete Docker deployment system out of the box.
+
+### Local (Docker Desktop)
+
+```bash
+npm run maker deploy:init        # Generate deploy files (one-time)
+npm run maker deploy:workflow    # Build and start everything
+```
+
+### Remote (VPS / Cloud)
+
+```bash
+npm run maker deploy:init                      # Generate files
+# Edit deploy/workflow.remote.json with your SSH details
+npm run maker deploy:workflow:remote           # Deploy to server
+```
+
+The deploy system provisions:
+
+- **Multi-stage Dockerfile** — builder (install + build) → runner (minimal production image)
+- **Shared infrastructure** — nginx-proxy, MySQL/PostgreSQL, Redis, phpMyAdmin, pgAdmin
+- **Auto SSL** — Let's Encrypt via nginx-proxy companion
+- **Process supervisor** — API server, queue worker, cron scheduler, auto-migration
+- **Two-layer architecture** — server infra runs once per host, app stack rebuilds per deploy
+
+See the [deploy documentation](https://niyamulahsan.github.io/nexwire/deploy/overview) for full details.
+
+## Documentation
+
+Complete documentation is available at **[Documentation](https://niyamulahsan.github.io/nexwire)**
+
+## Contributing
+
+Contributions are welcome. Open an issue or pull request on [GitHub](https://github.com/niyamulahsan/nexwire).
+
+## License
+
+nexwire is open-sourced software licensed under the [MIT license](LICENSE).

package/express/.dockerignore

@@ -0,0 +1,14 @@
+node_modules
+dist
+.git
+.gitignore
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+coverage
+*.log
+tmp
+temp

package/express/.env

@@ -0,0 +1,44 @@
+# ── App ────────────────────────────────────────────
+APP_NAME=nexwire
+APP_ENV=development
+APP_PORT=3000
+APP_URL=http://localhost:3000
+
+# Frontend origin when UI is on a different domain than the API.
+# Leave empty if UI is served from the same APP_URL.
+FRONTEND_URL=
+
+# ── Database ───────────────────────────────────────
+# Supported: sqlite:, mysql://, postgres://
+# Default is SQLite so a fresh clone runs with zero setup (no server to install).
+# The dev stack migrates + seeds automatically on first run.
+# Switch later, e.g. mysql://root:@localhost:3306/nexwire
+DATABASE_URL=sqlite:./src/storage/database/nexwire.sqlite
+
+# ── Secrets ────────────────────────────────────────
+JWT_ACCESS_SECRET=change-me-access
+JWT_REFRESH_SECRET=change-me-refresh
+COOKIE_SECRET=change-me-cookie
+STORAGE_ACCESS_KEY_ID=
+STORAGE_SECRET_ACCESS_KEY=
+MAIL_USERNAME=
+MAIL_PASSWORD=
+
+# ── Redis ──────────────────────────────────────────
+# Set true to enable cache, session, queue, events, and Queue Dashboard
+REDIS=false
+# Shared key prefix for cache, session, queue, events, and dashboards
+REDIS_URL=redis://127.0.0.1:6379
+REDIS_PREFIX=nexwire
+
+# ── Feature Toggle ─────────────────────────────────
+# Set false for API-only mode (no UI build/serve)
+UI=true
+# Set true to enable OpenAPI / Scalar docs at /api-docs
+OPEN_API=true
+# Set false to disable Socket.IO realtime server
+SOCKET=true
+# Set false to disable browser security headers (CSP, HSTS, X-Frame)
+SECURITY_HEADERS=true
+
+

package/express/.env.example

@@ -0,0 +1,42 @@
+# ── App ────────────────────────────────────────────
+APP_ENV=development
+APP_NAME=nexwire
+APP_PORT=3000
+APP_URL=http://localhost:3000
+
+# Frontend origin when UI is on a different domain than the API.
+# Leave empty if UI is served from the same APP_URL.
+FRONTEND_URL=
+
+# ── Database ───────────────────────────────────────
+# Supported: sqlite:, mysql://, postgres://
+# Default is SQLite so a fresh clone runs with zero setup (no server to install).
+# The dev stack migrates + seeds automatically on first run.
+# Switch later, e.g. mysql://root:@localhost:3306/nexwire
+DATABASE_URL=sqlite:./src/storage/database/nexwire.sqlite
+
+# ── Secrets ────────────────────────────────────────
+JWT_ACCESS_SECRET=change-me-access
+JWT_REFRESH_SECRET=change-me-refresh
+COOKIE_SECRET=change-me-cookie
+STORAGE_ACCESS_KEY_ID=
+STORAGE_SECRET_ACCESS_KEY=
+MAIL_USERNAME=
+MAIL_PASSWORD=
+
+# ── Redis ──────────────────────────────────────────
+# Set true to enable cache, session, queue, events, and Queue Dashboard
+REDIS=false
+# Shared key prefix for cache, session, queue, events, and dashboards
+REDIS_URL=redis://127.0.0.1:6379
+REDIS_PREFIX=nexwire
+
+# ── Feature Toggle ─────────────────────────────────
+# Set false for API-only mode (no UI build/serve)
+UI=true
+# Set true to enable OpenAPI / Scalar docs at /api-docs
+OPEN_API=true
+# Set false to disable Socket.IO realtime server
+SOCKET=false
+# Set false to disable browser security headers (CSP, HSTS, X-Frame)
+SECURITY_HEADERS=true

package/express/.vscode/settings.json

@@ -0,0 +1,26 @@
+{
+  "editor.defaultFormatter": "biomejs.biome",
+  "[typescript]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[typescriptreact]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[javascript]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[javascriptreact]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[json]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[jsonc]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "editor.codeActionsOnSave": {
+    "source.organizeImports.biome": "explicit",
+    "source.fixAll.biome": "explicit"
+  },
+  "files.eol": "\n"
+}

package/express/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 - present, niYam
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/express/README.md

@@ -0,0 +1,211 @@
+<p align="center">
+  <a href="https://github.com/niyamulahsan/nexwire">
+    <img alt="nexwire" src="https://raw.githubusercontent.com/niyamulahsan/nexwire/main/logo-favicon/nexwire.png" width="300">
+  </a>
+</p>
+
+<h3 align="center">Full-stack TypeScript framework for modern web applications</h3>
+
+<p align="center">
+  <a href="https://niyamulahsan.github.io/nexwire"><img src="https://img.shields.io/badge/docs-3b8eed" alt="Documentation"></a>
+  <a href="https://www.npmjs.com/package/create-nexwire"><img src="https://img.shields.io/npm/v/create-nexwire" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/create-nexwire"><img src="https://img.shields.io/npm/dt/create-nexwire" alt="npm downloads"></a>
+  <a href="https://github.com/niyamulahsan/nexwire/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="MIT License"></a>
+  <a href="https://github.com/niyamulahsan/nexwire"><img src="https://img.shields.io/github/stars/niyamulahsan/nexwire?style=social" alt="GitHub Stars"></a>
+</p>
+
+---
+
+nexwire is a batteries-included TypeScript framework that combines modular backends (Hono, Express) with Drizzle ORM, BullMQ, Socket.IO, Redis, and a Vue 3 SPA frontend — all scaffolded with a single command and deployed with Docker Compose.
+
+## Quick Start
+
+### Hono (default)
+
+```bash
+npm create nexwire@latest my-app
+cd my-app
+npm install
+npm run maker db:migrate --seed
+npm run maker dev
+```
+
+### Express
+
+```bash
+npm create nexwire@latest my-app -- --engine=express
+cd my-app
+npm install
+npm run maker db:migrate --seed
+npm run maker dev
+```
+
+Your API is live at `http://localhost:3000`, Scalar docs at `/api-docs`, and the Vue frontend at `http://localhost:5173`.
+
+Requires **Node.js >= 22.12** or **Bun >= 1.3**.
+
+### Current directory
+
+Scaffold directly into the current directory:
+
+```bash
+npm create nexwire@latest .
+npm create nexwire@latest . -- --engine=express
+```
+
+Works with any package manager: `pnpm`, `yarn`, or `bun`.
+
+### Package Manager
+
+All examples use `npm` as the default. nexwire works with any major package manager:
+
+| Manager  | Create project                     | Run commands          |
+| -------- | ---------------------------------- | --------------------- |
+| **npm**  | `npm create nexwire@latest my-app`  | `npm run maker <cmd>` |
+| **pnpm** | `pnpm create nexwire@latest my-app` | `pnpm maker <cmd>`    |
+| **yarn** | `yarn create nexwire@latest my-app` | `yarn maker <cmd>`    |
+| **bun**  | `bun create nexwire@latest my-app`  | `bun maker <cmd>`     |
+| **all**  | `npm create nexwire@latest .`       | current directory     |
+
+### Runtime
+
+nexwire runs on **Node.js** or **Bun** — pick whichever fits your deployment:
+
+| Runtime     | Minimum version | Notes                                                                 |
+| ----------- | --------------- | --------------------------------------------------------------------- |
+| **Node.js** | `>= 22.12`     | Default. Uses `node` in Dockerfile.                                   |
+| **Bun**     | `>= 1.3`        | Pass `--runtime=bun` to `deploy:init`. Uses `oven/bun` in Dockerfile. |
+
+## Features
+
+| Category            | What you get                                                                           |
+| ------------------- | -------------------------------------------------------------------------------------- |
+| **API**             | Hono/Express HTTP server with Zod validation, OpenAPI/Scalar docs, CORS, rate limiting |
+| **Database**        | Drizzle ORM — SQLite, MySQL, or PostgreSQL. Auto-detected from `DATABASE_URL`.         |
+| **Auth**            | JWT access + refresh token rotation, signed httpOnly cookies, role middleware          |
+| **Queue**           | BullMQ background jobs with `shouldQueue` decorator and Bull Board dashboard           |
+| **Realtime**        | Socket.IO with auto room joining (user, role, auth) and broadcast events               |
+| **Cache & Session** | Redis-backed with graceful fallback when Redis is disabled                             |
+| **Scheduler**       | Cron-based task scheduling with distributed Redis lock                                 |
+| **Storage**         | Local disk or S3-compatible (AWS S3, R2, MinIO, DigitalOcean Spaces)                   |
+| **Notifications**   | Database-persisted notifications with broadcast + mail delivery                        |
+| **Frontend**        | Vue 3 SPA — Vite, Pinia, Vue Router, Bootstrap 5, real-time Pulse plugin               |
+| **Security**        | CSP, HSTS, X-Frame headers — configured in one place, toggled per environment          |
+| **Reliability**     | Circuit breakers for Redis, mail, and S3 with auto-fallback; startup config validation |
+| **CLI**             | `maker` command for code generation, migrations, runtime, and deploy                   |
+| **Deploy**          | Two-layer Docker Compose — nginx-proxy, auto SSL, supervisor                           |
+
+## Architecture
+
+```
+src/
+├── env.ts              # Zod-validated environment config
+├── database/           # Drizzle schema, migrations, seeders
+├── framework/          # Reusable engine (HTTP, auth, queue, cache, etc.)
+├── modules/            # Application modules (auto-discovered)
+├── middlewares/        # Auth & role guards
+├── resources/          # Vue 3 SPA frontend
+└── storage/            # Uploaded files & logs
+```
+
+### Modules
+
+Every feature is a self-contained module under `src/modules/<name>/`:
+
+```
+src/modules/posts/
+├── console/           # CLI commands & scheduled tasks
+├── controllers/       # Request handlers + Zod schemas
+├── database/
+│   ├── models/        # Drizzle table definitions
+│   └── seeders/       # Test data generators
+├── jobs/              # BullMQ queue handlers
+├── routes/            # HTTP route definitions (auto-discovered)
+└── __test__/          # Unit test
+```
+
+Modules are **auto-discovered** — no manual registration. Create one with:
+
+```bash
+npm run maker module:make blog
+npm run maker module:make-controller blog post
+npm run maker module:make-route blog post
+npm run maker module:make-model blog post
+```
+
+### Framework Facade
+
+Access all subsystems through a single import:
+
+```ts
+import {
+  db,
+  cache,
+  session,
+  queue,
+  dispatchEvent,
+  notify,
+  storage,
+  jwt,
+  mail,
+  password,
+  urls,
+  logger,
+} from "@/framework/facade.js";
+```
+
+## CLI Reference
+
+| Command                        | Description                                    |
+| ------------------------------ | ---------------------------------------------- |
+| `maker dev`                    | Start API server + frontend HMR + queue worker |
+| `maker serve [--prod]`         | API server (dev or production)                 |
+| `maker queue:work`             | BullMQ worker process                          |
+| `maker schedule:work`          | Cron scheduler                                 |
+| `maker db:migrate --seed`      | Run migrations + seeders                       |
+| `maker db:fresh`               | Drop all tables, re-migrate, re-seed           |
+| `maker module:make <name>`     | Scaffold a new module                          |
+| `maker deploy:init`            | Generate Docker deploy scaffolding             |
+| `maker deploy:workflow`        | Local deploy (Docker Desktop)                  |
+| `maker deploy:workflow:remote` | Remote deploy via SSH + rsync                  |
+
+## Deployment
+
+nexwire includes a complete Docker deployment system out of the box.
+
+### Local (Docker Desktop)
+
+```bash
+npm run maker deploy:init        # Generate deploy files (one-time)
+npm run maker deploy:workflow    # Build and start everything
+```
+
+### Remote (VPS / Cloud)
+
+```bash
+npm run maker deploy:init                      # Generate files
+# Edit deploy/workflow.remote.json with your SSH details
+npm run maker deploy:workflow:remote           # Deploy to server
+```
+
+The deploy system provisions:
+
+- **Multi-stage Dockerfile** — builder (install + build) → runner (minimal production image)
+- **Shared infrastructure** — nginx-proxy, MySQL/PostgreSQL, Redis, phpMyAdmin, pgAdmin
+- **Auto SSL** — Let's Encrypt via nginx-proxy companion
+- **Process supervisor** — API server, queue worker, cron scheduler, auto-migration
+- **Two-layer architecture** — server infra runs once per host, app stack rebuilds per deploy
+
+See the [deploy documentation](https://niyamulahsan.github.io/nexwire/deploy/overview) for full details.
+
+## Documentation
+
+Complete documentation is available at **[Documentation](https://niyamulahsan.github.io/nexwire)**
+
+## Contributing
+
+Contributions are welcome. Open an issue or pull request on [GitHub](https://github.com/niyamulahsan/nexwire).
+
+## License
+
+nexwire is open-sourced software licensed under the [MIT license](LICENSE).

package/express/biome.json

@@ -0,0 +1,66 @@
+{
+  "$schema": "./node_modules/@biomejs/biome/configuration_schema.json",
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true
+  },
+  "formatter": {
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 140,
+    "bracketSameLine": true
+  },
+  "linter": {
+    "rules": {
+      "preset": "recommended",
+      "correctness": {
+        "noUnusedVariables": "off",
+        "useVueValidTemplateRoot": "off",
+        "noUnusedImports": "off"
+      },
+      "complexity": {
+        "noUselessEscapeInRegex": "off"
+      },
+      "style": {
+        "noNonNullAssertion": "off",
+        "useVueMultiWordComponentNames": "off",
+        "useImportType": "off"
+      },
+      "suspicious": {
+        "noEmptyBlockStatements": "off",
+        "noExplicitAny": "off",
+        "noRedeclare": "off",
+        "noAssignInExpressions": "off",
+        "useIterableCallbackReturn": "off"
+      }
+    }
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "double",
+      "semicolons": "always",
+      "trailingCommas": "none"
+    }
+  },
+  "overrides": [
+    {
+      "includes": ["**/*.{js,mjs,cjs,ts,tsx,vue}"],
+      "javascript": {
+        "globals": ["exports", "location"]
+      }
+    }
+  ],
+  "assist": {
+    "actions": {
+      "source": {
+        "organizeImports": {
+          "level": "on",
+          "options": {
+            "groups": [":NODE:", ":PACKAGE:", ":ALIAS:", ":PATH:"]
+          }
+        }
+      }
+    }
+  }
+}