The BEE Suite

Childcare CRM, school operations, billing, parent portal, teacher portal, and executive reporting platform.

Last refreshed: September 23, 2026

The BEE Suite is a multi-tenant, white-label operating system for childcare brands and schools. It supports inquiry intake, enrollment, families, children, classrooms, staffing, tuition billing, Stripe Connect payout setup, parent communications, documents, compliance workflows, FTE reporting, role-specific portals, and human-reviewed AI assistance.

Current State

• Production app: https://thebeesuite.io
• Hosting: Vercel project the-bee-suite
• Database/Auth/Storage: Supabase-backed Prisma application
• Payments: Stripe Checkout and Connect foundations with school payout onboarding and autopay billing workflows
• Communication: in-app messaging, SendGrid email paths, Twilio SMS foundations, notification preferences, and delivery logging
• Rollout focus: Kokomo may continue approved normal production use; the wider Kid City school wave and each sensitive module remain independently gated

Main User Flows

• Parents: /parents for parent login, /parent-portal for family account access, /parents/setup and /parent-portal/setup for onboarding/setup flows.
• Teachers: /teachers for teacher login and /teacher-portal for classroom-safe workflows.
• Directors: /directors for school operations login and /dashboard, /messages, /billing-settings, /staff, /documents, /attendance, /daily-reports, /incident-reports, /fte-reports, and related school modules.
• Executives: /executives for corporate login, /multi-location-dashboard, /agency-admin, /team-permissions, /analytics, /fte-reports, and cross-location reporting.
• Public/support: /, /app, /registration, /check-in, /support, /resources, /privacy, /login, /forgot-password, and /reset-password.

Most operating modules are served through src/app/[slug]/page.tsx with RBAC and center/family/classroom scoping enforced server-side.

Tech Stack

• Next.js 16 App Router, React 19, TypeScript, Tailwind CSS, shadcn-style UI primitives, Recharts, and lucide-react.
• Prisma 6 with Supabase/Postgres.
• Supabase Auth session-cookie login plus server-side user/access-grant checks.
• Stripe Checkout, Connect, billing webhooks, payment method setup, autopay/dunning/reminder cron routes, and terminal store checkout.
• SendGrid/Twilio integration paths for email/SMS and in-app notification records.
• Playwright-assisted visual capture scripts and Node test coverage for core workflows.

Repository Layout

.
├── docs/                 Operational docs, SOPs, rollout plans, launch guides, security notes
├── ios/                  Capacitor iOS parent shell
├── native/               Static native/PWA shell helpers
├── output/               Committed launch screenshots, graphics, and printable deliverables
├── prisma/               Prisma schema, seed data, and migrations config
├── public/               Brand/public assets
├── scripts/              Import, rollout, payout, setup, graphics, and validation scripts
├── src/
│   ├── app/              App Router pages, role portal routes, API routes, cron routes
│   ├── components/       Workspace panels, forms, dashboards, portal UI, shared UI primitives
│   └── lib/              Auth, RBAC, billing, communications, import, reporting, Stripe/Supabase helpers
├── supabase/             Supabase config and SQL migrations
├── tests/                Node test suite for guardrails and critical workflows
└── wordpress-avada/      Kid City public inquiry embed snippets

Local Setup

npm install
npm run cloud:link
npm run cloud:env
npm run dev

Open http://localhost:3000.

Use .env.example as the safe template. Do not commit .env.local, pulled production env files, SendGrid env files, or machine-specific Supabase/Vercel temp state.

For machine setup details, see docs/LOCAL_CLOUD_SETUP.md. For parallel Codespace quick fixes and isolated local worktrees, see docs/CLOUD_LOCAL_WORKFLOW.md.

Common Commands

npm run lint
npm run typecheck
npm test
npm run vercel-build
npm run cloud:validate
npm run work:quick -- <slug>
npm run work:tree -- <slug>
npm run test:smoke

Database and rollout helpers:

npm run db:generate
npm run db:migrate
npm run pilot:check
npm run procare:prepare-rendered -- <secure-export-directory> <ignored-review-directory>
npm run kidcity:ensure-corporate-schools
npm run kidcity:prepare-school-payouts

Production Vercel builds use:

npm run vercel-build

That command runs Prisma generate, lint, typecheck, the full Node test suite, and next build.

Environment Variables

Start from .env.example. Important production groups:

• App/auth: APP_URL, NEXT_PUBLIC_APP_URL, AUTH_SECRET, AUTH_PASSWORD_RESET_REDIRECT_URL
• Supabase/Postgres: DATABASE_URL, POSTGRES_URL, POSTGRES_PRISMA_URL, SUPABASE_URL, SUPABASE_ANON_KEY, SUPABASE_SERVICE_ROLE_KEY
• Stripe: STRIPE_SECRET_KEY, NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY, STRIPE_WEBHOOK_SECRET, Connect/payment fee settings, payout settings, and STRIPE_ACCOUNTS_V2_API_VERSION=2026-06-24.dahlia
• Messaging: SENDGRID_API_KEY, SENDGRID_FROM_EMAIL, Twilio account/auth/from/webhook settings, and server-only Web Push VAPID keys
• Operations: CRON_SECRET, OPENAI_API_KEY, Google Sheets/Calendar credentials where enabled

See docs/DEPLOYMENT.md, docs/STRIPE_CONNECT.md, and docs/STRIPE_CONNECT_SETUP.md.

This is the beginning of the README. Read the rest at the original. Read the full README ↗