AdonisBlue
AdonisBlue is a practice management platform built for aesthetic nurse injectors. It gives nurses an AI-powered client chatbot, automated aftercare emails, a client hub for logging treatments, emergency monitoring, and Stripe-based subscription billing — all in one place. Nurses set up their bot once and AdonisBlue handles client intake, aftercare, rebooking reminders, and follow-ups automatically.
Tech Stack
| Layer | Technology |
|---|
| Framework | Next.js 16 (App Router, server components, API routes) |
| Database & Auth | Supabase (Postgres + Row Level Security + Auth) |
| Hosting | Vercel (auto-deploy from main) |
| Email | Resend |
| Payments | Stripe (subscriptions, webhooks, billing portal) |
| AI | Anthropic Claude (chatbot, aftercare generation, prep guides) |
| SMS Alerts | Twilio |
| Newsletter | Beehiiv |
Running Locally
# 1. Clone
git clone https://github.com/your-org/adonisblue.git
cd adonisblue
# 2. Install dependencies
npm install
# 3. Set environment variables
cp .env.example .env.local
# Fill in all values in .env.local (see Environment Variables below)
# 4. Start dev server
npm run dev
App runs at http://localhost:3000.
Environment Variables
Copy .env.example to .env.local and fill in every value. See .env.example for descriptions of each variable.
Required for core functionality:
NEXT_PUBLIC_SUPABASE_URLNEXT_PUBLIC_SUPABASE_ANON_KEYSUPABASE_SERVICE_ROLE_KEYANTHROPIC_API_KEYRESEND_API_KEYNEXT_PUBLIC_APP_URL
Required for billing:
STRIPE_SECRET_KEYSTRIPE_WEBHOOK_SECRETSTRIPE_PRICE_STARTER_MONTHLY / STRIPE_PRICE_STARTER_ANNUALSTRIPE_PRICE_PRO_MONTHLY / STRIPE_PRICE_PRO_ANNUAL
Required for emergency SMS alerts:
TWILIO_ACCOUNT_SIDTWILIO_AUTH_TOKENTWILIO_PHONE_NUMBER
Required for cron jobs:
Key Directories
app/
├── api/ # All API routes (Next.js Route Handlers)
│ ├── chat/ # AI chatbot endpoint — handles client messages, emergency detection
│ ├── treatments/ # Log treatments, send aftercare emails
│ ├── intakes/ # Client intake records (CRUD)
│ ├── send-aftercare/ # Send aftercare email to a specific client
│ ├── send-prep-guide/ # Send pre-appointment prep guide email
│ ├── generate-aftercare/ # Claude: generate aftercare for custom procedures
│ ├── generate-prep-instructions/ # Claude: generate prep guide for custom procedures
│ ├── incidents/ # Emergency incident feed (flag, resolve, delete)
│ ├── emergency-keywords/ # Custom emergency keyword management
│ ├── cron/ # Scheduled jobs (rebooking reminders, review requests)
│ ├── admin/ # Internal admin routes (preview mode, feedback, user management)
│ └── stripe-webhook/ # Stripe webhook handler (subscription lifecycle)
│
├── dashboard/ # Nurse dashboard (main home after login)
├── aftercare/ # Client Hub — log treatments, send aftercare, monitor emergencies
├── chat/[slug]/ # Public AI chatbot for clients (nurse's branded chat page)
├── healing/[treatment_id]/ # Client post-treatment recovery chat
├── onboarding/ # New nurse setup flow (bot config, procedures, profile)
├── admin/ # Internal admin panel (nurse list, feedback, preview mode)
├── auth/ # Login, magic link, password reset
├── insights/ # Analytics (treatment stats, bot conversion)
├── survey/[id]/ # Post-treatment client satisfaction survey
└── ref/[slug]/ # Referral tracking pages
Cron Jobs
Cron jobs live in app/api/cron/ and are configured in vercel.json. They run on a schedule and are protected by the CRON_SECRET bearer token.
| Route | Schedule | What it does |
|---|
/api/cron/reminders | Daily | Sends rebooking reminder emails when a client's reminder date has passed |
/api/cron/treatment-reminders | Daily | Sends treatment follow-up reminders |
/api/cron/reviews | Daily | Sends post-treatment review request emails |
To test a cron job locally, call the endpoint with Authorization: Bearer <CRON_SECRET>.
Deploying
Push to main → Vercel auto-deploys.
git push origin main
Make sure to also configure in Vercel / external services:
- Stripe webhook pointing to
https://yourdomain.com/api/stripe-webhook
- Supabase Auth redirect URLs to include your production domain
- Vercel Cron jobs (defined in
vercel.json)
- All environment variables set in the Vercel project dashboard
