The Garden Protocol
"Every verified document is a seed. Every QR scan plants trust."
The Discovery
What began as a simple fix for WhatsApp sharing became something larger: a complete distribution mechanism that transforms verification into propagation. We call it the Garden Protocol.
Core insight: The verification page isn't just proof of authenticity. It's a trust propagation point. Every receipt verified is an opportunity to plant a new seed.
Traditional document systems end at verification. The user confirms authenticity and closes the tab. But what if verification was the beginning of distribution, not the end?
The Viral Loop
The loop has no friction. No registration required to verify. No app download needed. The recipient simply scans the QR code on a physical document, sees the verification result, and encounters two calls-to-action:
- Share this verification via Web Share API (native mobile sharing)
- "What is WINDI?" CTA that leads to the landing page
Technical Implementation
Web Share API
We implemented the native Web Share API for mobile devices, with intelligent fallback for desktop browsers:
function windiShareVerification(receiptId, docTitle) {
const verifyUrl = 'https://windi-domain.com/verify-public/?id='
+ encodeURIComponent(receiptId);
const shareData = {
title: 'Document verified by WINDI',
text: 'This document has been cryptographically verified...',
url: verifyUrl
};
if (navigator.share && navigator.canShare(shareData)) {
navigator.share(shareData); // Native share sheet
} else {
copyToClipboard(verifyUrl); // Desktop fallback
}
}
Mobile Native
On iOS/Android, the Web Share API opens the native share sheet, allowing direct sharing to WhatsApp, Telegram, Signal, iMessage, and any installed app.
navigator.share()Desktop Fallback
On desktop browsers without Web Share support, we copy the verification URL to clipboard with visual feedback.
clipboard APIWhatsApp Split Buttons
The Communique Builder now offers two distinct WhatsApp sharing options:
- Content: Sends the full document content as formatted text
- Verify Link: Sends just the verification URL with receipt ID
This separation emerged from a key insight: some recipients need the content, others need proof. The split buttons serve both needs without compromise.
OG Meta Tags
Every verification page now includes proper Open Graph meta tags, ensuring beautiful previews when shared on social platforms:
<meta property="og:title" content="Document Verified by WINDI"> <meta property="og:description" content="Cryptographic verification..."> <meta property="og:image" content="[preview image URL]">
Breath Fields
As part of Garden Protocol v0.7.0-G, we added "breath" fields to the document metadata. These are poetic, trilingual descriptions that give each document type a soul:
These breath fields appear in the Palette UI as category subtitles, adding a human dimension to the governance layer. The 14 document types now have their own poetic identity.
Commits Log
| Hash | Description |
|---|---|
| c3d2e1f | fix(palette): Replace purple accent with WINDI Gold in WICK component |
| a1b2c3d | feat(garden): Add breath fields and category subtitles to Palette |
| d4e5f6a | feat(verify): Add WhatsApp share + copy link to verify-public |
| b7c8d9e | fix(builder): Change localhost URLs to domain URLs for production |
| f0a1b2c | feat(builder): Activate WhatsApp share, split Content/Verify buttons |
| e3d4c5b | feat(verify): Add Web Share API for native mobile sharing |
| a6b7c8d | feat(garden): Add "What is WINDI?" CTA to complete viral loop |
Distribution Vectors
"The document isn't the product. The document is the seed. Verification isn't validation. Verification is propagation."
The Garden Protocol identifies three primary distribution vectors:
- Physical Loop: Printed document > QR code > scan > verify > share > new user
- Digital Loop: Email/message > verify link > verify > share > new user
- Hybrid Loop: Physical meeting > digital verification > social sharing
Each vector has zero friction. No app installation. No account creation. No barrier between verification and distribution.
Constitutional Alignment
The Garden Protocol maintains full constitutional compliance:
- I1 Sovereignty: Human decides to share. AI only facilitates.
- I2 Transparency: All sharing mechanisms are visible and optional.
- I3 Zero-Knowledge: Only receipt IDs are shared, never document content.
- I9 Autonomy Prohibition: No automatic sharing. Every share requires human action.
Next Steps
- Analytics integration to track viral coefficient
- A/B testing of CTA placement and copy
- QR code visual redesign with WINDI branding
- Referral attribution system for enterprise tiers
Principle discovered: In governance systems, verification is not the end of the value chain. It is the beginning of distribution. Every verified document is a trust ambassador.