BellaBella
Product Architecture

How Bella thinks.

A family-first AI assistant. Below is the end-to-end flow — from input to action — across reminders, kashrus, holidays, and shared family life.

Inputs

Voice notes

Web Speech API

Flyer & screenshot uploads

Vision parsing

SMS replies

Twilio inbound

Hebcal & Zmanim

Jewish calendar

Bella Engine

Claude (Anthropic)

Intent + entity extraction

Rules engine

Kashrus, Shabbos, Yom Tov

Family graph

Members, prefs, history

RLS & audit

Per-family isolation

Outputs

Push notifications

Web Push (VAPID)

SMS

Twilio Programmable

Phone calls

Twilio Voice + TwiML

WhatsApp

Twilio Business API

End-to-end flow

Mom speaks

Claude parses

Rules engine

Save to DB

Notify

Voice / text / image

Multimodal capture from PWA

Intent extraction

“Add candles to shopping for Friday”

Constraint check

Kashrus, Shabbos, time-zone, family roles

Persistence

Supabase Postgres with RLS per family

Delivery

Channel + time chosen by preference

Rules engine

Shabbos guard
Always-on safeguards.
  • If event time falls within candle-lighting → Havdalah window, defer all outbound channels.
  • Surface a 'before Shabbos' digest 90 minutes prior.
  • Auto-mute SMS, calls, push, and WhatsApp until motzei Shabbos.
Yom Tov awareness
Always-on safeguards.
  • Pull holiday list from Hebcal by ZIP.
  • Apply melacha restrictions to outbound messaging.
  • Add 'pre-Yom Tov shopping' reminder 5 days before Pesach, Sukkos, Shavuos.
Kashrus
Always-on safeguards.
  • Tag meal plan items as Meat / Dairy / Pareve.
  • Block adjacent meat→dairy meals within 6 hours.
  • Surface kosher-certified vendor when added to shopping.
Family graph
Always-on safeguards.
  • Each member has roles: parent, child, grandparent.
  • Birthdays add yearly recurring reminders + Hebrew date.
  • Permissions cascade: Mom > Family > read-only.
Reminder routing
Always-on safeguards.
  • Choose channel by urgency × user pref (push → SMS → call).
  • Voice fallback if SMS unread within 20 min.
  • Snooze/escalate ladder before marking missed.
Privacy & isolation
Always-on safeguards.
  • Per-family RLS in Postgres.
  • All AI calls run server-side with redacted payloads.
  • PII never sent to model logs.

Stack at a glance

Client

React 19 · Vite · TanStack Router · PWA

Backend

Supabase Auth + Postgres + Storage

AI

Anthropic Claude · Web Speech API · Vision

Messaging

Twilio SMS · Voice · WhatsApp · Web Push

Calendar

Hebcal · Zmanim · ZIP-based geolocation

Hosting

Vercel · Edge functions · CI from GitHub

Observability

OpenTelemetry · Sentry · LogTail

Payments

Stripe (Bella+ subscription)

Want to see it in motion?

Step into the app and explore each role.

Enter Bella