Deelrx CRM
Privacy-first POS, CRM, inventory, and credit management system for small businesses
A modern, full-stack CRM and point-of-sale system built with Next.js 16, Supabase, and TypeScript. Designed specifically for retail dispensaries and small businesses requiring robust inventory tracking, customer credit management, and AI-powered business intelligence.
Monorepo Reality (Beta Launch Baseline)
This repository is a pnpm monorepo. Product ownership is explicit:
apps/app = the .app product (authenticated operator experience)apps/marketing = marketing site only (.com)
Node Version Policy
- Required Node.js:
20.18.0 (exact)
- Package manager:
[email protected]
- CI and local policy are aligned (
.nvmrc, .node-version, package engines)
If you are using nvm:
nvm use
Domain Routing (.com -> .app)
- Marketing CTAs on
apps/marketing should send users to the .app domain routes (for example /login, /register)
- Middleware in
apps/app/middleware.ts owns the redirect rules that prevent loops between /, /login, /onboarding, and /dashboard
NEXT_PUBLIC_APP_URL should point to the .app origin (for example https://deelrxcrm.app)
Clerk Redirect / Origin Checklist
Configure these in Clerk for both local and production environments:
- Allowed origins: marketing
.com origin(s) and app .app origin(s)
- Sign-in URL:
.app/login
- Sign-up URL:
.app/register
- After sign-in URL:
.app/dashboard (or .app/onboarding if your flow requires setup first)
- After sign-up URL:
.app/onboarding (or .app/dashboard if onboarding is complete)
- Local dev origins and redirects:
http://localhost:3000 / http://localhost:3001 (match your active ports)
Do not point marketing CTAs to in-domain auth pages on .com; they should always link to .app.
Quick POS (Operator Fast Path)
Quick POS lives in apps/app and is designed as a minimal ring-up flow:
/pos/sale → search/scan/add items/pos/payment → tender + receipt selection/pos/complete → receipt/confirmation state and quick reset for next sale
The POS checkout contract is centralized in /Users/lee/Projects/DRX_Primary/apps/app/lib/pos/contract.ts.
wrelik-kit Consumption
- DRX consumes
@wrelik/* from published packages (registry-pinned versions)
- Vendored
packages/wrelik-* are not source-of-truth and are excluded from workspace resolution
- Direct vendor SDK imports are restricted by ESLint; use app/mobile adapters and
@wrelik/* boundaries instead
See /Users/lee/Projects/DRX_Primary/docs/WRELIK_KIT_INTEGRATION.md for details.
Policies
Policy source of truth is root canonical files:
./WRELIK_AGENTS.md./DEVELOPMENT_PROCESS.md./RELEASE_POLICY.md./VERSIONING_POLICY.md./VERSION_MANAGEMENT_POLICY.md./STACK_POLICY.md./CHECKLIST_PRECOMMIT.md./CHECKLIST_PRERELEASE.md
Upstream template provenance and import procedure:
./POLICY_UPSTREAM.mddocs/POLICY_IMPORT_WORKFLOW.md
Staging / Preview Testing
For preview deploy + demo data seeding (including the current shared-DB warning), see:
/Users/lee/Projects/DRX_Primary/docs/STAGING_PREVIEW_WORKFLOW.md
🚀 Features
Canonical source:
docs/MARKETING_TRUE_FEATURE_LIST.mddocs/MARKETING_FEATURE_CLAIM_MATRIX.md
DRX Marketing Canon (Status-Aware)
- Fast Point of Sale (
Live, refund tracking claim Beta) - clean checkout, scan/search, discounts, multiple payments, customer lookup, transaction history
- Quick POS Mode (
Live) - scan product, adjust quantity, apply discount, take payment, done
- Inventory That Actually Makes Sense (
Live, purchase-order tracking claim Beta) - stock visibility, low-stock alerts, SKU/barcode, batch/vendor tracking, adjustment logs
- Customer Tracking That Works (
Live, notes/tags + loyalty claim Beta) - profiles, purchase history, customer insights
- Real Business Reports (
Live, downloadable/deep slices claim Beta) - sales windows, category and best-seller visibility, revenue context, dashboard overview
- Team Control & Accountability (
Live) - role-based control, secure login, and user activity visibility
- Multi-Location Ready (
Beta) - separate store views and central multi-business administration
- Works on Desktop and Mobile (
Live) - desktop dashboards with mobile-friendly checkout and cloud access
- DRX Privacy ProteXion™ (
Live) - alias-first tracking, encrypted sensitive fields, screen masking, and operator-controlled retention with minimal data footprint
🛠 Tech Stack
Frontend
- Next.js 16 (App Router, React 19)
- TypeScript - Type-safe development
- Tailwind CSS - Utility-first styling
- Shadcn/ui - High-quality component library
- Sonner - Toast notifications
- Lucide Icons - Modern icon set
Backend
