docs: add tiered pricing model to design spec

Three paid tiers: Manage ($12/mo, admin-only + embeddable widgets),
Cloud ($25/mo, full hosted site), API add-on (+$5/mo). Self-hosted
remains free. Updated revenue projections and billing products.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-03-26 13:09:38 -05:00
co-authored by Claude Opus 4.6
parent 8aeebac63c
commit d192062793
@@ -96,7 +96,7 @@ CREATE TABLE tenants (
port INT NOT NULL, port INT NOT NULL,
admin_email VARCHAR(255) NOT NULL, admin_email VARCHAR(255) NOT NULL,
admin_name VARCHAR(255) NOT NULL, admin_name VARCHAR(255) NOT NULL,
plan ENUM('trial', 'cloud', 'self_hosted') DEFAULT 'trial', plan ENUM('trial', 'manage', 'cloud', 'self_hosted') DEFAULT 'trial',
stripe_customer_id VARCHAR(255), stripe_customer_id VARCHAR(255),
stripe_subscription_id VARCHAR(255), stripe_subscription_id VARCHAR(255),
status ENUM('provisioning', 'active', 'suspended', 'deleted') DEFAULT 'provisioning', status ENUM('provisioning', 'active', 'suspended', 'deleted') DEFAULT 'provisioning',
@@ -492,9 +492,42 @@ Provisioning script automates: create DB, run migrations, seed admin user, clone
- Platform DB backed up independently - Platform DB backed up independently
- 30-day retention after tenant deletion - 30-day retention after tenant deletion
### Pricing Tiers
| Tier | Price | What They Get |
|------|-------|---------------|
| **Self-Hosted** | Free | Full source code, run it yourself, MIT licensed |
| **Manage** | $12/mo | Admin dashboard + foster portal only. No hosted public site. Embeddable pet widgets for their existing website. |
| **Cloud** | $25/mo | Full hosted website + management + subdomain + SSL + backups + updates |
| **API Add-on** | +$5/mo | REST API access for custom integrations (available on Manage or Cloud) |
**Trial:** 14 days free on any paid tier (no card required)
**Why tiered pricing:**
- Most rescues already have a website (WordPress, Facebook page, etc.). The **Manage** tier captures rescues that want better management tools but don't want to switch their whole site.
- **Embeddable widgets** bridge the gap — a JS snippet that shows available pets on their existing site, pulling from FosterFlow data. Displays "Powered by FosterFlow" (marketing for upgrades).
- **Cloud** is the premium experience — full hosted site + management, zero setup.
- **API access** lets tech-savvy rescues build custom integrations or embed data however they want.
**Manage tier details:**
- Tenant gets admin dashboard + foster portal (same app, just no public routes served)
- Caddy routes their subdomain to admin/foster only
- Embeddable widgets: `<script src="https://{slug}.fosterflow.app/embed/pets.js"></script>` renders a pet grid on any page
- Widget is an iframe or web component pulling from the existing `/api/pets` endpoint
- Lower infrastructure cost (no public traffic, just admin users)
**Revenue projections (updated):**
| Tenants | Mix (Manage/Cloud) | Monthly Revenue | Server Costs | Margin |
|---------|-------------------|----------------|--------------|--------|
| 10 | 5/5 | $185 | $15 | $170 |
| 50 | 30/20 | $860 | $30 | $830 |
| 100 | 60/40 | $1,720 | $60 | $1,660 |
| 500 | 300/200 | $8,600 | $200 | $8,400 |
### Billing (Stripe) ### Billing (Stripe)
- **Product:** FosterFlow Cloud ($19/mo) - **Products:** FosterFlow Manage ($12/mo), FosterFlow Cloud ($25/mo), API Add-on (+$5/mo)
- **Trial:** 14 days free (no card required) - **Trial:** 14 days free (no card required)
- **Webhook events:** - **Webhook events:**
- `customer.subscription.created` → activate tenant - `customer.subscription.created` → activate tenant
@@ -506,7 +539,8 @@ Provisioning script automates: create DB, run migrations, seed admin user, clone
## Reference ## Reference
- **Domain:** fosterflow.app
- **AHCR source:** `../almosthomecaninerescue.com-2026/ahcr/` - **AHCR source:** `../almosthomecaninerescue.com-2026/ahcr/`
- **Market:** ~10,000 rescue organizations in the US, ~14,000 total animal welfare orgs - **Market:** ~10,000 rescue organizations in the US, ~14,000 total animal welfare orgs
- **Differentiator:** Full website + management in one (competitors are mostly backend-only tools) - **Differentiator:** Full website + management in one (competitors are mostly backend-only tools). Manage tier captures rescues that just want the backend.
- **Competition:** Shelterluv ($2/adoption), RescueGroups (free), Petstablished (free), BARRK ($20/mo) - **Competition:** Shelterluv ($2/adoption), RescueGroups (free), Petstablished (free), BARRK ($20/mo)