Free, open-source loyalty implementations for the Deakee partner ecosystem.
⚠️ Architecture transition (2026-05-11) — these plugins are mid-pivot from the old OAuth2-server-in-plugin model to the new two-layer model described in the Plugin Integration Standard. The spec docs indocs/are current. The plugin code underplugins/is still the previous design; rewrites are in progress. Use the docs as the source of truth, not the code.
| Tier | Brand profile | How they connect | Exchange access |
|---|---|---|---|
| 1a — Bespoke display-only | Famous brands (Nike, Starbucks, Sam's, AAdvantage) | Custom OAuth2 read-only adapter | ❌ View only |
| 1b — Platform adapter display-only | Brands on Yotpo / Smile.io / LoyaltyLion / Klaviyo | One Deakee adapter per platform | ❌ View only |
| 2 — Full Deakee partner | Mid-size brands willing to integrate fully | Plugin (WooCommerce, Magento, Shopify, …) + ERC-8063 bridge | ✅ Full access |
Tier 1 makes Deakee a loyalty aggregator (Plaid-style): users see balances from Nike, Starbucks, every Yotpo brand in one app. Read-only. The points stay in the brand's own system.
Tier 2 makes Deakee a loyalty infrastructure provider (Stripe-style): the plugin is a full centralized loyalty program (earn on purchase, redeem at checkout — all in the partner's own DB) plus a bridge layer that lets the customer voluntarily mint their centralized points into on-chain ERC-8063 tokens for cross-brand trading.
The chain only enters on user-initiated bridge operations. Mint never fires on every purchase — purchase is a private event inside the partner's app.
| Path | What it is | Status |
|---|---|---|
packages/core |
Shared TS: relayer client, identity OAuth2, voucher verify, ABI helpers. Currently the old OAuth2-server code — rewrite in progress. | rewriting |
packages/sdk |
@deakee/loyalty-sdk — npm-published subset for custom integrators |
rewriting |
packages/dashboard |
Shared React admin components (Tier 2 dashboard) | planned |
packages/adapters |
Tier 1 adapters (Yotpo, Smile.io, LoyaltyLion, NikePlus, …) | planned |
| Path | Platform | Status |
|---|---|---|
plugins/starter |
Next.js standalone e-commerce starter | rewriting |
plugins/woocommerce |
WordPress + WooCommerce | rewriting |
plugins/laravel |
Laravel 10+ | rewriting |
plugins/magento2 |
Magento 2 CE/EE | rewriting |
plugins/opencart |
OpenCart 3.x / 4.x | rewriting |
plugins/shopify |
Shopify App Store | rewriting |
plugins/prestashop |
PrestaShop 1.7+ | rewriting |
plugins/bigcommerce |
BigCommerce App Marketplace | rewriting |
Read in this order:
docs/FEATURE_OVERVIEW.md— three-tier overview, architecturedocs/PLUGIN_INTEGRATION_STANDARD.md— the Tier 2 contract: centralized + bridgedocs/DISPLAY_ONLY_INTEGRATION.md— Tier 1 (aggregator) contractdocs/POINT_ISSUANCE_MODEL.md— earn (centralized) + bridge mechanicsdocs/PLATFORM_PLUGINS.md— per-platform detailsdocs/CROSS_BRAND_NETWORK.md— the CEX (Tier 2 tokens only)docs/HOSTED_SERVICE.md— managed option for no-platform partnersdocs/PARTNER_DASHBOARD.md— admin UI specdocs/SELF_SERVE_ONBOARDING.md— partner wizard
MIT. See LICENSE.