How joekaltho/kaltrix-os works
KaltrixOS is a small-business operating platform combining public business discovery and profiles with an owner dashboard for managing listings, customers, bookings, invoices, messages, expenses, and subscriptions. Public visitors can contact businesses and submit or report reviews; owners monitor business performance and trust signals, while plan status gates dashboard features. The graph focuses on these product stages and their Supabase-backed runtime. Several page and integration implementations were not sampled, so those branches are shown only where paths or relationships are supported by the index.
Main entry points: client.ts Supabase browser access · page.tsx Owner dashboard · service.ts Supabase service access · route.ts Review submission
Components 27
Public discovery
- Discover businesses
src/app/(public)/discover/page.tsx - Public business profile
src/app/(public)/business/[slug]/page.tsx - Account signup
src/app/signup/page.tsx
Business workspace
- Owner dashboard
src/app/(dashboard)/dashboard/page.tsx - Overview metrics
src/components/dashboard/OverviewPanel.tsx - Business pulse
src/components/BusinessPulsePanel.tsx - Listing management
src/components/ListingsPanel.tsx - Booking management
src/components/dashboard/BookingsPanel.tsx - Customer management
src/components/dashboard/CustomersPanel.tsx - Invoice management
src/components/dashboard/InvoicesPanel.tsx - Business inbox
src/components/dashboard/InboxPanel.tsx - Create records
src/app/(dashboard)/dashboard
Trust and engagement
- Review submission
src/app/api/reviews/route.ts - Review reporting
src/app/api/review-reports/route.ts - Message submission
src/app/api/messages/route.ts - Trust scoring
src/lib/trust-score.ts
Plans and payments
- Subscription state
src/lib/check-plan.ts - Plan upgrade
src/app/(dashboard)/dashboard/upgrade/page.tsx - Paystack webhook
src/app/api/webhooks/paystack/route.ts - Email service
Data and access
- Input validation
src/lib/validation.ts - API safeguards
src/lib/api-guard.ts - Supabase browser access
src/lib/supabase/client.ts - Supabase service access
src/lib/supabase/service.ts - Supabase
Other components
- Visitor
- Business owner
Connections 39
- Visitor → Discover businesses: browses
- Visitor → Public business profile: views
- Visitor → Review submission: submits review
src/app/api/reviews/route.ts - Visitor → Review reporting: reports review
src/app/api/review-reports/route.ts - Visitor → Message submission: sends message
src/app/api/messages/route.ts - Business owner → Account signup: registers
- Business owner → Owner dashboard: manages business
- Owner dashboard → Overview metrics: renders
src/app/(dashboard)/dashboard/page.tsx - Owner dashboard → Business pulse: renders
src/app/(dashboard)/dashboard/page.tsx - Owner dashboard → Listing management: renders
src/app/(dashboard)/dashboard/page.tsx - Owner dashboard → Business inbox: renders
src/app/(dashboard)/dashboard/page.tsx - Owner dashboard → Overview metrics: uses plan checks
src/components/dashboard/OverviewPanel.tsx - Overview metrics → Trust scoring: uses scoring
src/components/dashboard/OverviewPanel.tsx - Business pulse → Supabase browser access: reads and writes
src/components/BusinessPulsePanel.tsx - Listing management → Supabase browser access: reads and writes
src/components/ListingsPanel.tsx - Invoice management → Supabase browser access: loads invoice data
- Booking management → Supabase browser access: loads booking data
- Customer management → Supabase browser access: loads customer data
- Business inbox → Supabase browser access: loads messages
- Create records → Supabase browser access: creates records
src/app/(dashboard)/dashboard/page.tsx - Public business profile → Supabase browser access: reads business data
src/app/(public)/business/[slug]/page.tsx - Review submission → Input validation: validates input
src/app/api/reviews/route.ts - Review submission → API safeguards: rate limits
src/app/api/reviews/route.ts - Review submission → Supabase service access: inserts review
src/app/api/reviews/route.ts - Review reporting → Input validation: validates input
src/app/api/review-reports/route.ts - Review reporting → API safeguards: rate limits
src/app/api/review-reports/route.ts - Review reporting → Supabase service access: submits report
src/app/api/review-reports/route.ts - Message submission → Input validation: validates input
src/app/api/messages/route.ts - Message submission → API safeguards: rate limits
src/app/api/messages/route.ts - Message submission → Supabase service access: stores message
src/app/api/messages/route.ts - API safeguards → Supabase service access: uses client
src/lib/api-guard.ts - Supabase service access → Supabase: connects
- Supabase browser access → Supabase: connects
- Subscription state → Supabase browser access: queries subscription
src/lib/check-plan.ts - Owner dashboard → Subscription state: checks plan
src/app/(dashboard)/dashboard/page.tsx - Plan upgrade → Subscription state: resolves plan
- Paystack webhook → Supabase service access: updates subscription
src/app/api/webhooks/paystack/route.ts - Paystack webhook → Subscription state: uses plan definitions
src/app/api/webhooks/paystack/route.ts - Supabase → Email service: waitlist email flow