Vibe Solutions - OpenVerb CRM Reference Implementation 🚀✨

This is an official Reference Implementation of a modern Next.js SaaS project integrated with the OpenVerb CRM Ecosystem.

It demonstrates how a "Developer-Native" CRM can be "slid" into an existing architecture using the Master Template pattern. Instead of a rigid NPM package, the entire CRM engine and dashboard are injected directly into your source code—giving you 100% control over the UI, branding, and database.

🏗️ Architectural Foundations

This project is built on two core principles:

1. BYOD (Bring Your Own Database)

OpenVerb CRM operates over a generic db object interface found in lib/crm/store.ts.

• By default, this repo uses a high-performance in-memory mock for instant testing.
• To swap for production: Simply update the db export in lib/crm/store.ts to point to your live Prisma, Drizzle, or Supabase client.

2. BYOP (Bring Your Own Provider)

The lib/crm/email-adapter.ts translates standard OpenVerb actions (like draft.send) into your provider's API. Native support for Resend, Postmark, Sendgrid, and AWS SES.

---

🛡️ Commercial Ecosystem & Licensing

This implementation includes the OpenVerb "Phone-Home" Engine.

• The app performs a secure handshake with the OpenVerb.org Registry on every boot.
• It verifies its CRM_LICENSE_KEY to unlock Tier-specific features (Enterprise Federation, AI Roles, etc.).

---

🚀 Getting Started

1. Clone the Repo
2. Install Dependencies: npm install
3. Configure Environment:
   • Copy .env.example to .env
   • Set your CRM_APP_ID, CRM_LICENSE_KEY, and CRM_REGISTRY_URL.
4. Run the App: npm run dev
5. Visit the Dashboard: Hit /inbox or /contacts to see the live CRM in action!

---

🍱 Architecture Updates

You can always refresh the core logic or UI components without losing your customizations by running:

npx @openverb/crm init