How jmldigital/crmbuff works
Crmbuff is a multi-tenant, configurable CRM: users register and work with their organization’s custom object types, fields, records, and status pipelines. Managers browse filtered, paginated records and track events; admins configure object types and teams, and can transfer records. The graph follows the sampled records and events query/mutation paths. The README documents tenant isolation, duplicate-phone checks, cloning and cascade deletion, and an email-lead foundation; unsampled implementations are represented cautiously. Supabase is the persistence/auth boundary; database enforcement details were not sampled.
Main entry points: records.service.ts Record data service · RecordTable.tsx Record table and pipeline · page.tsx Record pages · RecordForm.tsx Record forms
Components 21
Access and tenancy
- Marketing and signup
platform/src/app/(marketing)/page.tsx - Authentication
platform/src/features/auth/server.ts - Tenant access
platform/src/middleware.ts
CRM workspace
- App shell
platform/src/app/app/AppShell.tsx - Organization onboarding
platform/src/app/app/onboarding/page.tsx - Record pages
platform/src/app/app/[objectType]/page.tsx - Record table and pipeline
platform/src/features/records/components/RecordTable.tsx - Record forms
platform/src/features/records/components/RecordForm.tsx - Event timeline
platform/src/features/events/components/EventTimeline.tsx
Administration
- Object types and fields
platform/src/features/object-types/components/ObjectTypesList.tsx - Team administration
platform/src/app/admin/team/page.tsx
Data services
- Dynamic schema builder
platform/src/features/records/services/schema-builder.ts - Record query hooks
platform/src/features/records/hooks/use-records.ts - Record mutation hooks
platform/src/features/records/hooks/use-record-mutations.ts - Record data service
platform/src/features/records/services/records.service.ts - Event hooks
platform/src/features/events/hooks/use-events.ts - Event service
platform/src/features/events/services/events.service.ts - Supabase client
platform/src/lib/supabase/browser.ts - Supabase Postgres
- Email lead foundation
platform/src/lib/supabase/database.types.ts
Other components
- CRM user
Connections 24
- CRM user → Marketing and signup: visits or registers
- Marketing and signup → Authentication: submits signup
- CRM user → App shell: opens workspace
platform/src/app/app/AppShell.tsx - App shell → Tenant access: passes access check
- CRM user → Organization onboarding: sets up organization
- CRM user → Object types and fields: configures types
- CRM user → Team administration: manages team
platform/src/app/admin/team/page.tsx - CRM user → Record pages: opens records
platform/src/app/app/[objectType]/page.tsx - Record pages → Record table and pipeline: renders table
- Record pages → Record forms: renders form
- Record forms → Dynamic schema builder: builds validation
platform/src/features/records/components/RecordForm.tsx - Record table and pipeline → Record query hooks: queries page
platform/src/features/records/components/RecordTable.tsx - Record table and pipeline → Record mutation hooks: mutates records
platform/src/features/records/components/RecordTable.tsx - Record forms → Record mutation hooks: saves record
- Record query hooks → Record data service: fetches data
platform/src/features/records/hooks/use-records.ts - Record mutation hooks → Record data service: calls mutations
platform/src/features/records/hooks/use-record-mutations.ts - Record table and pipeline → Record data service: loads event counts
platform/src/features/records/components/RecordTable.tsx - Record data service → Supabase client: queries records
platform/src/features/records/services/records.service.ts - Event timeline → Event hooks: uses event hooks
platform/src/features/events/components/EventTimeline.tsx - Event hooks → Event service: calls event operations
platform/src/features/events/hooks/use-events.ts - Event service → Supabase client: queries events
platform/src/features/events/services/events.service.ts - Supabase client → Supabase Postgres: reads and writes
- Record data service → Supabase Postgres: invokes CRM RPCs
platform/src/features/records/services/records.service.ts - Email lead foundation → Supabase Postgres: documents lead schema