Business-WrapBusiness-Wrap بزنس راببزنس راب
Free and open source · MIT · v0.11.0

Business-Wrap: the bilingual requirements document generator

Evidence in. One document, two languages.

  • Give it a process model or a walk through the live service.
  • Edit on the page that prints. Arabic right to left, English left to right.
  • Export PDF and DOCX, fonts embedded as real text.

Runs on your computer. Node 20+, Chrome or Edge. No account.

مجاني ومفتوح المصدر · MIT · الإصدار 0.11.0

بزنس راب: مولّد وثائق المتطلبات ثنائي اللغة

أدلة تدخل. وثيقة واحدة بلغتين.

  • أعطه نموذج الإجراء أو جولة في الخدمة الحية.
  • حرّر على الصفحة نفسها التي تُطبع. العربية من اليمين، والإنجليزية من اليسار.
  • صدّر PDF وDOCX، والخطوط مضمّنة نصا حقيقيا.

يعمل على جهازك. Node 20 أو أحدث، وChrome أو Edge. بلا حساب.

Business-Wrap: two pages on one spine, Arabic and English, one highlighter stroke across both
Evidence, highlighted and boundالدليل، مُعلَّما ومُجلَّدا
How it works

Evidence, then the editor, then PDF and DOCX

  1. Evidence

    A process model gives roles, workflow, rules and statuses. A walk through the live service gives the card, the form, attachments and messages. The merge keeps both.

  2. Editor

    One HTML file. The page you edit is the page that prints. Every change is recorded and can be undone.

  3. PDF + DOCX

    Both editions, with the fonts embedded as real, selectable text. Plus the edits file and a design pack.

كيف يعمل

الأدلة، ثم المحرر، ثم PDF وDOCX

  1. الأدلة

    نموذج الإجراء يعطي الأدوار وسير العمل والقواعد والحالات. والجولة في الخدمة الحية تعطي البطاقة والنموذج والمرفقات والرسائل. والدمج يحتفظ بالاثنين.

  2. المحرر

    ملف HTML واحد. الصفحة التي تحرّرها هي الصفحة التي تُطبع. كل تغيير مسجّل ويمكن التراجع عنه.

  3. PDF وDOCX

    النسختان معا، والخطوط مضمّنة نصا حقيقيا قابلا للتحديد. ومعهما ملف التعديلات وحزمة التصميم.

Features

What you get

One idea per card. Hover or focus a card to play its icon.

Two ways in

Start from BPMN, draw.io or YAML, or from a crawl of the live service.

The page is the print

Every printed word, table and label is editable where it sits.

Both languages first-class

Arabic and English editions side by side. The layout never flips.

Diagrams you can edit

Shapes, arrows with bends, labels in place. Mermaid in and out.

Any font, real text

The project's fonts, this computer's, or an uploaded file, embedded in PDF and DOCX.

Tools that explain themselves

Rest on a tool: a card names it, shows its shortcut and plays what it does.

Six template packs

E-service, e-commerce, call-centre, approval, SaaS and generic IEEE 29148, plus your own.

The crawler stops before Send

A crawl is a dry run. Filing a real request needs two explicit switches.

A gate on every rule

Client content, credentials and local paths are kept out of the repository.

For your AI agent

A Claude Code plugin and a local MCP server: build, edit, export, harvest.

المزايا

ما تحصل عليه

فكرة واحدة في كل بطاقة. مرّر المؤشر على البطاقة أو انتقل إليها لتتحرك أيقونتها.

طريقان للدخول

ابدأ من BPMN أو draw.io أو YAML، أو من جولة في الخدمة الحية.

الصفحة هي المطبوعة

كل كلمة مطبوعة وكل جدول وعنوان قابل للتعديل في مكانه.

اللغتان بالمنزلة نفسها

النسخة العربية والإنجليزية جنبا إلى جنب. والتخطيط لا ينقلب.

مخططات قابلة للتعديل

أشكال وأسهم بانحناءات ونصوص في مكانها. واستيراد Mermaid وتصديره.

أي خط، نصا حقيقيا

خطوط المشروع أو خطوط جهازك أو ملف ترفعه، مضمّنة في PDF وDOCX.

أدوات تشرح نفسها

توقّف على أداة: تظهر بطاقة باسمها واختصارها وحركة تبيّن عملها.

ست حزم قوالب

الخدمة الإلكترونية والتجارة الإلكترونية ومركز الاتصال والموافقات وSaaS وIEEE 29148 العامة، وحزمتك أنت.

المسح يتوقف قبل الإرسال

المسح تشغيل تجريبي. ولا يُقدَّم طلب حقيقي إلا بمفتاحين صريحين.

فحص لكل قاعدة

محتوى العملاء وبيانات الدخول والمسارات المحلية تبقى خارج المستودع.

لوكيل الذكاء الاصطناعي

إضافة Claude Code وخادم MCP محلي: بناء وتحرير وتصدير وحصاد.

Install

Pick one way in

All three run on your computer.

Easiest

Claude Code plugin

The skill and the MCP server together.

/plugin marketplace add NJ-Burrito/Business-Wrap
/plugin install business-wrap@business-wrap

Then say "build the requirements document for …" or "open it in the editor".

Any MCP client

MCP server

Get the code (clone, or the release zip with its .sha256), run npm ci, then:

claude mcp add business-wrap -- node <path>/Business-Wrap/mcp/cli.mjs

Latest release zip. Needs Node 20+, Chrome or Edge for the PDF, uv for the DOCX.

No agent

From source

Build the sample and open it in the editor.

git clone https://github.com/NJ-Burrito/Business-Wrap
cd Business-Wrap
npm ci
npm run sample
npm run serve

Opens on http://127.0.0.1:4317/ with one-click PDF + DOCX.

التثبيت

اختر طريقة واحدة

الطرق الثلاث تعمل على جهازك.

الأسهل

إضافة Claude Code

المهارة وخادم MCP معا.

/plugin marketplace add NJ-Burrito/Business-Wrap
/plugin install business-wrap@business-wrap

ثم قل: «ابنِ وثيقة متطلبات …» أو «افتحها في المحرر».

أي عميل MCP

خادم MCP

احصل على الشيفرة (نسخة من المستودع، أو ملف الإصدار المضغوط مع ملف .sha256)، ونفّذ npm ci، ثم:

claude mcp add business-wrap -- node <path>/Business-Wrap/mcp/cli.mjs

ملف آخر إصدار. يحتاج Node 20 أو أحدث، وChrome أو Edge لملفات PDF، وuv لملفات DOCX.

بلا وكيل

من المصدر

ابنِ الوثيقة النموذجية وافتحها في المحرر.

git clone https://github.com/NJ-Burrito/Business-Wrap
cd Business-Wrap
npm ci
npm run sample
npm run serve

يفتح على http://127.0.0.1:4317/ مع تصدير PDF وDOCX بنقرة واحدة.

Updates

New versions reach you, with your consent

  • In the editorOpened through npm run serve, it checks at launch, at most once a day. A popup shows what is new: Update now, Later, or Skip.
  • Your work is never touchedProgram files only. Documents, edits, fonts and logos stay. Any failure puts the previous version back.
  • Claude Code plugin/plugin marketplace update business-wrap, then /plugin update business-wrap.
  • Terminal or agentnode update/cli.mjs --check, then --apply --yes. Every version is a GitHub release.
التحديثات

الإصدارات الجديدة تصلك، بموافقتك

  • داخل المحررعند فتحه عبر npm run serve يفحص عند البدء، مرة في اليوم على الأكثر. وتعرض نافذة ما الجديد: حدّث الآن، أو لاحقا، أو تخطَّ.
  • عملك لا يُمسّملفات البرنامج فقط. المستندات والتعديلات والخطوط والشعارات تبقى. وأي فشل يعيد الإصدار السابق.
  • إضافة Claude Code/plugin marketplace update business-wrap ثم /plugin update business-wrap.
  • الطرفية أو الوكيلnode update/cli.mjs --check ثم --apply --yes. وكل إصدار منشور على GitHub.
FAQ

Short answers

Is it free?

Yes. MIT licence, no paid plan, no account.

Does my document leave my computer?

No. The editor, the PDF printer and the DOCX builder run locally.

The one automatic request is the update check: at most once a day, to the public GitHub release list. Webhooks send only to an address you set.

Do I need Claude?

No. The editor and the command line work on their own. The plugin and the MCP server are optional.

What goes in, what comes out?

In: a process model (BPMN, draw.io, YAML) or a crawl of a live service.

Out: PDF, DOCX, the edits JSON, a design pack, and the editor saved as HTML.

Will the crawler file a real request?

Not unless you ask twice: submit: true in the config and --yes-file-real-request. Otherwise it stops before Send, Submit, Confirm or Pay.

Which fonts can I use?

Thmanyah by default, any font on your computer, or a file you upload. The font's licence is your responsibility; font files are not included.

What does it run on?

Tested on Windows 11 with Node 24 and Chrome. It needs Node 20+, Chrome or Edge, and Python with uv for DOCX. macOS and Linux are untested.

أسئلة شائعة

إجابات قصيرة

هل هو مجاني؟

نعم. رخصة MIT، بلا خطة مدفوعة وبلا حساب.

هل تغادر وثيقتي جهازي؟

لا. المحرر وطابعة PDF ومنشئ DOCX تعمل كلها على جهازك.

الطلب التلقائي الوحيد هو فحص التحديث: مرة في اليوم على الأكثر، إلى قائمة الإصدارات العامة على GitHub. وخطافات الويب ترسل فقط إلى عنوان تحدده أنت.

هل أحتاج Claude؟

لا. المحرر وسطر الأوامر يعملان وحدهما. والإضافة وخادم MCP اختياريان.

ماذا يدخل وماذا يخرج؟

يدخل: نموذج إجراء (BPMN أو draw.io أو YAML) أو مسح لخدمة حية.

يخرج: PDF وDOCX وملف التعديلات JSON وحزمة التصميم والمحرر محفوظا بصيغة HTML.

هل يقدّم المسح طلبا حقيقيا؟

لا، إلا إذا طلبت ذلك مرتين: submit: true في الإعدادات و--yes-file-real-request. وإلا توقف قبل الإرسال أو التقديم أو التأكيد أو الدفع.

أي الخطوط أستخدم؟

خط ثمانية افتراضيا، أو أي خط على جهازك، أو ملف ترفعه. ترخيص الخط مسؤوليتك، وملفات الخطوط غير مضمّنة.

على أي نظام يعمل؟

جُرّب على Windows 11 مع Node 24 وChrome. ويحتاج Node 20 أو أحدث، وChrome أو Edge، وPython مع uv لملفات DOCX. ولم يُجرَّب على macOS ولينكس.