Skip to content
hwmpsPublic

About

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

 
 

Latest commit

 

History

59 Commits

Folders and files

Repository files navigation

Neul

An AI phone assistant that supports families when a caregiver cannot answer.

A parent calls their child's existing number. When a tested conditional-forwarding setup routes an unanswered call to Neul, the AI identifies itself, uses caregiver-provided context, and talks with the parent. The caregiver reviews call summaries in the Neul app (an installable PWA) and receives alerts when follow-up may be needed.

Product boundaries

  • The child receives the original call first.
  • The AI discloses that it is AI; no voice cloning or impersonation.
  • Caregivers enter and edit parent information through the app.
  • Neul does not provide medical advice or call emergency services. Escalation goes to the primary caregiver, then the backup contact.
  • Location is shared only when the parent taps "I'm lost" in Parent Mode, for at most 30 minutes. Neul never tracks location in the background.
  • Development and demo data must be fictional.

Modes

Mode Device Purpose
Caregiver Mode Child's phone Setup, parent profile, contacts, call feed and detail, alerts, Lost Mode map
Parent Mode (/parent, optional) Parent's smartphone Paired once by code, no login, PIN-locked; one "I'm lost" button that shares location and dials the child

Neul works without Parent Mode (phone line + voice clues + the family's own location app).

Stack

Twilio (phone) · Retell (voice AI) · AI model chosen by comparison · Supabase (database, auth, functions, live updates) · Next.js PWA on Vercel · Leaflet + OpenStreetMap · TypeScript

Start here

  1. Read the product plan and decisions.
  2. Find your weekly tasks in the work plan.
  3. Review the architecture, data model, and draft contracts.
  4. Follow the contribution workflow and safety rules.
  5. Use fictional examples to build independently.

Local setup

Use Node.js 22 or newer. In app/, run npm ci then npm run dev. Follow Supabase setup for migration, fictional seed, account assignment, environment variables and verification commands.

Copy app/.env.example to app/.env.local for the two public Supabase settings. Root .env.example documents future server integration variables. Never commit credentials or real family data.

Document status

See source reconciliation for how the plan PDFs, the team discussion and the 2026-10-13 build plan were combined.

About

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages