docs(readme): explicit cli integration instructions, component usage details, and standardized social advocacy triggers

Author: Corey B

README.md

@@ -33,4 +33,48 @@ FDD adoption solves both infrastructure and data consumption bottlenecks. We bel
 4. **Interact Your Way**: FDD separates presentation from true data. View it with the built-in UI, load it into an office suite, use it for data modeling, query it directly in your coding IDE, or feed it to an AI Agent—the choice is yours.
 5. **Decentralized APIs**: Removes the massive root infrastructure cost of building API endpoints for institutions. Instead of building webhooks to support parallel and downstream industries (e.g. the mortgage industry needing bank statements, or colleges needing school records), institutions can simply issue a secure, verifiable `.fdd` file to the user.
 
-Join us in creating the future of standard file formats.
+## Tooling & Ecosystem Guide
+The OpenFDD ecosystem provides a full suite of typescript/javascript libraries to securely compose, sign, view, and inherently interact with FDD files.
+
+### 1. Composing & Building (`node-fdd`)
+To build an `.fdd` file from your backend, you pack your Cryptographic JSON, your Mutable JSON, and your HTML template securely into the unified `.fdd` document wrapper:
+```bash
+node lib/node-fdd/src/pack.js template.html fdd-data.json user-notes.json output.fdd
+```
+
+### 2. Cryptographic Signing
+If you are the official Issuer (e.g. a Bank), you must mathematically sign the JSON payload before packing it:
+```bash
+node lib/node-fdd/src/sign.js path/to/privateKey.pem fdd-data.json 
+```
+
+### 3. Parsing & Viewing Natively (`fdd-js`)
+To seamlessly render `.fdd` containers natively on your own web-platform without requiring plugins, simply reference the native layout library within your DOM. It evaluates the No-JS constraints, routes Ephemeral State actions securely, and renders the Document safely!
+```html
+<script src="/path/to/lib/fdd-js/src/fdd.js"></script>
+```
+
+### 4. Viewing Locally (`Chrome Extension`)
+For End-Users navigating to FDD files natively on their disk, the custom routing extension acts as a Security Shield. It intercepts raw text rendering to sandbox the format, gracefully bypasses restrictive OS bounds allowing direct file-system saves, and actively prunes malware requests!
+
+---
+
+## 📣 How You Can Help Advocate!
+The success of OpenFDD relies entirely on community pushback against static PDFs. Help spread the word!
+
+**Share the Standard on Social Media:**
+<p align="left">
+  <a href="https://twitter.com/intent/tweet?text=Stop%20sending%20dead%20PDFs.%20Documents%20should%20be%20data-first,%20not%20pictures%20of%20data.%20Learn%20why%20%23OpenFDD%20and%20Zero-JS%20interactive%20JSON-LD%20containers%20are%20the%20future%20of%20files!%20%20%0A%0A%F0%9F%93%84%20https://github.com/Spuds0588/open-fdd">
+    <img src="https://img.shields.io/badge/Share%20on%20X-000000?style=for-the-badge&logo=x&logoColor=white" alt="Share on X" />
+  </a>
+  <a href="https://www.linkedin.com/sharing/share-offsite/?url=https://github.com/Spuds0588/open-fdd">
+    <img src="https://img.shields.io/badge/Share%20on%20LinkedIn-0077b5?style=for-the-badge&logo=linkedin&logoColor=white" alt="Share on LinkedIn" />
+  </a>
+</p>
+
+**Action Items for Devs:**
+1. **Pitch it to your PM:** If your app exports user dashboards as 'PDF Printouts', propose securely exporting a `.fdd` "mini-app" instead. 
+2. **Build Integrations:** Build robust parsing libraries in Rust, Python, or Go for the `fdd-data` layer!
+3. **Star the Repo:** Help signal to the W3C and major browser vendors that developers want explicitly trusted, High-Trust File Sandbox permissions natively!
+
+Join us in creating the future of standard file formatting.