Project

    Family Shapes

    Family Shapes is a multi-surface relationship platform for donor-conceived family ecosystems, spanning family, donor, clinic, and community experiences.

    DAR

    Narrative

    01

    Why it matters

    Family Shapes tackles a messy and emotionally sensitive problem space: donor-conceived family ecosystems. The product is trying to hold together relationship discovery, privacy and consent, donor health stewardship, communication boundaries, and institutional workflows for clinics or cryobanks in one connected system. The live Supabase schema confirms that this is not just a landing-page story: the repo has real relationship, donor, organization, community, and media structures behind it.

    02

    What the product is

    Family Shapes is a multi-surface relationship platform, not a single-purpose family-tree app. It spans family-facing tools, a dedicated donor experience, a clinic or cryobank SaaS layer, and a broader community surface for stories, forums, and resources. The linked Supabase schema shows those layers connect through family trees, donor profiles, organizations, memberships, invitations, forums, posts, and media tables rather than existing as disconnected marketing ideas.

    System surfaces

    Recipient or family platform

    Recipient families

    Family-facing onboarding, dashboards, family trees, people, and donor-relative connection management under privacy constraints.

    Donor platform

    Donors

    A distinct donor experience for profile management, privacy controls, health updates, and communication settings.

    Clinic or cryobank SaaS platform

    Clinics and cryobanks

    Professional onboarding, organization dashboards, member management, and operational oversight for institutions.

    Community layer

    Community participants

    Stories, forums, resources, and broader community support around donor-conceived family experiences.

    Implementation stack

    Frontend

    • • React 18
    • • TypeScript
    • • Vite
    • • Tailwind CSS
    • • Radix / shadcn-style UI primitives

    Backend and data

    • • Supabase Auth
    • • Postgres
    • • Edge Functions
    • • Row-level security
    • • Migration-first schema workflow
    • • Linked remote type generation

    Visualization

    • • XYFlow / React Flow
    • • Dagre
    • • ELK
    • • D3

    Quality and operations

    • • Playwright end-to-end coverage
    • • Docs-first project governance
    • • Permissions and privacy hardening

    Evidence

    24 artifacts grouped by type so each kind of proof can be scanned on its own.

    Data models

    7 artifacts
    data model

    Community Content And Media Model

    The linked schema confirms that Family Shapes includes a real content and community system. Forums branch into threads and posts, blog posts branch into comments, resources stand on their own, and media albums link to media files through join rows.

    10 entities1 diagram
    data modelMay 17, 2026

    Donor Boundary and Health Model

    The donor surface is backed by a distinct donor profile model that connects privacy settings, health updates, and donor-recipient relationship state instead of treating donor controls as simple account preferences.

    5 entities1 diagram
    data model

    Donor Profile And Connection Model

    The donor layer is real in the schema, not just the UI. `donor_profiles` stores donor-specific identity, privacy, and health fields, while `donor_recipient_connections` tracks the relationship state between donor profiles, organizations, and recipient-side users.

    7 entities1 diagram
    data modelMay 17, 2026

    Organization and Oversight Model

    The clinic and cryobank layer depends on organizations as the tenant and oversight anchor, tying professional users to shared operational views, people records, and family relationship context.

    6 entities1 diagram
    data model

    Organization Membership And Oversight Model

    The remote schema makes the institutional layer much clearer: organizations connect to memberships, invitations, user profiles, groups, family trees, persons, and donor-recipient operations. That is a stronger SaaS and coordination story than the earlier editorial model captured.

    8 entities1 diagram
    data model

    Relationship Graph And Access Model

    The linked Supabase schema shows Family Shapes as a graph product with explicit access control. Family trees can belong to groups or organizations, persons join trees through membership rows, connections link people, and collaborator plus invitation tables govern who can work inside a sensitive tree.

    8 entities1 diagram
    data modelMay 17, 2026

    Relationship Graph Core

    Family Shapes centers the product on family trees, people, and connections, then layers collaboration and invitations on top so sensitive relationship graphs can be explored and maintained safely.

    6 entities1 diagram

    Workflows

    3 artifacts
    workflowMar 14, 2026

    Clinic / Cryobank Operational Oversight

    How professional operators enter the clinic-facing surface, onboard an organization context, and use the dashboard for member management and donor-program oversight.

    7 steps1 record
    workflowMar 14, 2026

    Donor Control and Health Update Workflow

    How donors use Family Shapes to manage profile completeness, privacy choices, health history, and communication settings through a dedicated donor experience.

    7 steps1 record
    workflowMar 14, 2026

    Family Discovery and Connection Journey

    How recipient families move from discovery and onboarding into privacy-aware family-tree exploration, connection review, and relationship follow-up.

    8 steps1 record

    Images

    7 artifacts
    Clinic or cryobank surface for professional donor oversight. — Family Shapesimage

    Clinic or cryobank surface for professional donor oversight.

    Community surface for stories, forums, and resources. — Family Shapesimage

    Community surface for stories, forums, and resources.

    Donor surface focused on privacy, transparency, and control. — Family Shapesimage

    Donor surface focused on privacy, transparency, and control.

    Public home or umbrella entry point for the overall Family Shapes product. — Family Shapesimage

    Public home or umbrella entry point for the overall Family Shapes product.

    Signed-in clinic or organization dashboard (`Rainbow Family Clinic`) showing organization metrics and operational overview. — Family Shapesimage

    Signed-in clinic or organization dashboard (`Rainbow Family Clinic`) showing organization metrics and operational overview.

    Signed-in donor dashboard showing donor profile completeness, privacy level, and health-update status. — Family Shapesimage

    Signed-in donor dashboard showing donor profile completeness, privacy level, and health-update status.

    Signed-in family dashboard showing family-tree stats, privacy settings, and linked organizations. — Family Shapesimage

    Signed-in family dashboard showing family-tree stats, privacy settings, and linked organizations.

    Chats

    1 artifact
    chatMay 26, 2026

    Gemini Donor Gamete Industry Research for Family Shapes

    Gemini AI Mode thread researching cryobank workflows, donor-profile verification gaps, cross-bank registry blind spots, and technical requirements for a Family Shapes transparency and privacy platform.

    1 chat

    Notes

    6 artifacts
    note

    Family Shapes Product Surfaces

    A linked breakdown of the family, donor, clinic or cryobank, and community surfaces that make Family Shapes a multi-surface platform.

    1 topic1 scope
    note

    Project Master Plan

    Product vision, scope, and system map for Family Shapes

    1 topic1 scope
    note

    "Product brief: Family Shapes"

    One-page product summary covering users, problem, MVP scope, and success metrics

    1 topic1 scope
    note

    Donor Portal

    Comprehensive documentation of the Donor Portal feature

    1 topic1 scope
    note

    Security/Sharing/Permissions/Privacy Audit (P1.1)

    Inventory and rationalization across frontend and backend

    1 topic1 scope
    note

    1018 – SaaS Portal Platform

    Plan and implement a multi-tenant SaaS portal for cryobanks and clinics with RBAC, billing, analytics, and professional workflows, separate from the Family and Donor apps

    1 topic1 scope

    Connected references

    Family Shapes Fresh Intake Archiveproject · 5 edges →Clinic / Cryobank Operational Oversightworkflow · 1 edge →Donor Boundary and Health Modelnote · 1 edge →Donor Control and Health Update Workflowworkflow · 1 edge →Family Discovery and Connection Journeyworkflow · 1 edge →Gemini Donor Gamete Industry Research for Family Shapeschat · 1 edge →Organization and Oversight Modelnote · 1 edge →Relationship Graph Corenote · 1 edge →

    Key dates

    2024-12-15
    Project initialization

    Initial repo setup established Family Shapes as an active product build rather than a concept stub.

    2025-03-20
    Graph and privacy-aware foundation

    Family-tree visualization, people, connections, Supabase, and RLS gave the project its core relationship-graph shape.

    2025-08-06
    Multi-surface platform baseline

    Interactive tree builder, organization maturity, donor portal, onboarding, and end-to-end testing made the product feel like a real ecosystem platform.

    2025-10-02
    Permissions system refactor

    The collaborator and invitation model became a first-class concern, showing how central privacy and access control are to the product.

    2025-10-03
    Platform separation and hardening

    The roadmap and changelog show explicit movement toward clearer family, donor, and SaaS boundaries plus continued RLS hardening.