Project

    Aerial

    I’m building Aerial as a trust layer for the donor-gamete industry: connected family, donor, and institutional workspaces for shared records, permission-aware networks, and evidence people can review and act on. It grows out of Family Shapes and is the current home for that work.

    DAR

    Narrative

    01

    From Family Shapes to Aerial

    I started with Family Shapes to make family and donor relationships visible. Aerial carries that work into a larger question: how do families, donors, and institutions keep the same records connected over time, with clear responsibility for updates? I now position it as a trust layer for the donor-gamete industry. The two Family Shapes projects remain historical records, including their original screenshots; this is the current project.

    02

    One connected story across three portals

    I built a fictional cast for the product demos so the same people and records can be followed across roles. Maya Brooks sees her family and sibling network, Evan Park maintains donor information, and Dr. Lena Ortiz works in Harbor Cryobank. The current family dashboard distinguishes 23 recorded families and 34 children from the 12 families whose identities are visible. Those numbers describe synthetic demonstration data, not customer adoption or industry coverage.

    03

    Transparency has to preserve choice

    I chose to separate recorded totals from permission to see a person. Identity, photos, location, and contact details have separate sibling and donor audiences; institutional records and care access follow their own rules. The family canvas makes biological, legal-parent, and donor relationships visible without treating those roles as interchangeable. The screenshots show saved sharing choices and the connected canvas, while the schema and permission tests document the underlying constraints.

    04

    Records need a human follow-through

    I expanded the workflow from viewing a network to handling capacity, medical notices, correction requests, and source discrepancies. Institutions can track recorded families separately from reservations, assign follow-up, and review versioned evidence. AI comparison is useful for finding disagreements in authorized documents, but a human reviewer must inspect the sources and record a decision and rationale. A matching name or an AI finding is not proof that two donor identities are the same.

    05

    The design and demo work are part of the evidence

    I used Codex for implementation, synthetic fixture preparation, visual iteration, and repeatable demo capture. I reviewed the resulting pages and videos, revised the narrative, and kept the connected-atlas direction across the marketing site. The September 12–13 releases brought the lavender visual system and a Resources hub with a glossary, industry timeline, and videos that play inline or in a modal. The artifacts here connect that design work to the product instead of treating a polished homepage as evidence that every workflow is complete.

    06

    What is working, and what remains open

    The September 14 review opened the current YC family, donor, and institutional demo accounts and captured the live application alongside the public site. The implementation and earlier delivery evidence cover permission boundaries, recorded outcomes, capacity, notices, and human source review. I still treat member-claim verification tiers, broader laboratory inventory, external institutional integrations, and complete reporting across institutions as limits. These demos establish product behavior with fictional records; they do not establish real clinical outcomes or universal coverage.

    07

    Health history follows the conversation

    I can follow the same synthetic story from Maya’s message to Evan’s dated health update and back into the family feed. The donor workspace shows four shared updates and one private preparation note; Maya sees the four shared donor updates alongside her own family-authored record. I keep sibling-family, donor, and clinic audiences separate, and donor profile fields have their own default and exceptions. Evan’s medical-history profile field is clinic-only. These are saved demo states, with self-reported history clearly distinguished from a clinical finding.

    08

    A receipt does not erase the work still owed

    I keep medical notices and correction requests separate from social sharing. The current synthetic notice shows 23 eligible families, 20 acknowledgments, two awaiting acknowledgment, and one family needing clinic follow-up. Maya’s saved acknowledgment records receipt. Her correction request remains overdue, assigned to Daniel Reed, and has no final response. The disputed imported birth date and original source version remain visible on both sides of the request. A draft response has not resolved or corrected anything.

    09

    Institutional operations stay attached to specific records

    I connect HBR-2041’s donor record, the Brooks recipient record, and their people and files to the operational work. The cryobank capacity view shows 23 recorded families plus two reservations against its own 25-family policy. That is a fully committed allocation, with historical outcomes and unresolved cases still reviewable. Harbor’s accepted Northstar partnership remains distinct from permission to a particular case: a case owner must authorize access, and each institution chooses the evidence it contributes. I use the screenshots and source-linked workflows to show these boundaries and the remaining human decisions.

    System surfaces

    Aerial public site

    Families, donors, institutions

    I explain the shared trust problem and how family, donor, and institutional workspaces fit together.

    Family network and canvas

    Families

    I connect family relationships, recorded outcomes, and the identities each person chooses to share.

    Sharing and privacy

    Families

    I keep sibling and donor audiences separate, with field-level choices and a preview of saved visibility.

    Donor workspace

    Donors

    I give donors a connected view of their recorded network, shared updates, and private information.

    Institutional operations and evidence review

    Institutional staff

    I connect donor and recipient records to capacity, notices, corrections, authorized source comparison, and human decisions.

    Resources

    Public

    I bring the glossary, timeline, videos, and external resources into a coherent learning surface.

    Family health and follow-up

    Families

    I connect family-authored updates, shared donor history, and follow-up conversations while keeping notice receipts separate.

    Requests and medical notices

    Families

    I preserve notice acknowledgments and correction receipts with their deadlines, original values, and response state.

    Donor health history

    Donors

    I keep dated donor updates, private preparation notes, selected sharing, and reminders in one workspace.

    Donor profile field visibility

    Donors

    I distinguish the default field audience, individual exceptions, managing-clinic access, and separate identity permissions.

    Capacity, notices, and corrections

    Institutional staff

    I connect family capacity, reservations, versioned notices, and source correction review to accountable follow-up.

    Donor and recipient records

    Institutional staff

    I connect recipient networks to their donor, people, permitted files, and accepted coordination relationships.

    Institution partnerships

    Institutional administrators

    I separate mutual institutional agreement from time-limited permission to a particular case.

    Implementation stack

    Application

    • Next.js 16
    • React 19
    • TypeScript
    • Tailwind CSS
    • Radix UI

    Identity and records

    • Better Auth
    • Drizzle ORM
    • Neon PostgreSQL

    Visual and operational surfaces

    • XYFlow
    • relationship canvases
    • versioned evidence review
    • Resend

    Evidence

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

    Data models

    1 artifact

    Workflows

    13 artifacts
    workflowWork date: Date unknown

    Aerial — authorized evidence and human follow-through

    I connect authorized source evidence to a human review decision, while keeping identity uncertainty and follow-up visible.

    5 steps1 record
    workflowWork date: Date unknown

    Aerial — Cryobank donor and recipient record review

    I keep donor and recipient oversight connected to the exact person, file, claim, and accepted relationship behind each record. The Brooks family view links directly to HBR-2041, two children, visible files, and clinic coordination.

    5 steps1 record
    workflowWork date: Date unknown

    Aerial — Cryobank family capacity and reservation reconciliation

    I track recorded families, reservations, children, and institution-specific policy separately. HBR-2041 currently has 23 recorded families and two reservations against a 25-family limit, so its capacity is fully committed.

    6 steps1 record
    workflowWork date: Date unknown

    Aerial — Cryobank notice review, family receipt, and follow-up

    I keep a medical notice’s reviewed content, eligible audience, availability, acknowledgment, and staff follow-up distinct. The synthetic notice has 23 eligible families, 20 acknowledgments, two pending receipts, and one clinic follow-up.

    6 steps1 record
    workflowWork date: Date unknown

    Aerial — design review and connected demo release

    I use Codex to implement and capture a connected product story, then review the visual result and narrative before release.

    5 steps1 record
    workflowWork date: Date unknown

    Aerial — Donor health history and sharing

    I keep donor health updates dated and distinguish the shared record from private preparation notes. The current demo shows four shared updates, one private update, and a future reminder.

    5 steps1 record
    workflowWork date: Date unknown

    Aerial — Donor profile fields and separate identity access

    I separate a donor’s general profile audience, individual field exceptions, and identity access. Evan’s saved medical-history exception is clinic-only while four other fields use the Personal Networks audience.

    5 steps1 record
    workflowWork date: Date unknown

    Aerial — Family health updates and independent audiences

    I give families a way to record their own health context and follow donor updates without combining their audiences. The current Brooks account shows one family-authored update and four shared donor updates.

    5 steps1 record
    workflowWork date: Date unknown

    Aerial — Family request to institutional correction review

    I preserve a family’s correction request alongside the disputed source value, deadline, and responsible reviewer. This demo request is overdue and has no final response; its draft has not corrected the record.

    6 steps1 record
    workflowWork date: Date unknown

    Aerial — Family–donor conversation to a shared health record

    I connect an accepted family–donor conversation to the dated health history it prompts. Maya’s question and Evan’s reply remain in the thread, and his later shared update gives that context a durable home.

    5 steps1 record
    workflowWork date: Date unknown

    Aerial — Institution partnership and scoped case access

    I treat institutional agreement and case permission as separate decisions. Harbor’s accepted Northstar partnership and pending Lakeview request show why an institutional relationship alone cannot open a patient roster or donor evidence.

    5 steps1 record
    workflowWork date: Date unknown

    Build one connected product demo across three roles

    The September 5–8 Aerial demo followed the same fictional family, donor and institution through working product states. A synthetic roster supplied realistic scale while role-specific sharing and visible-versus-recorded counts kept the story truthful. Production evolved through versioned films, narration, transcripts, contact sheets and playback checks. Project 0086 identifies V12 as the latest technically delivered draft and explicitly pauses further video work pending user direction and editorial acceptance.

    7 steps1 record
    workflowWork date: Date unknown

    Recover approved positioning before revising a product site

    Aerial’s September 8–13 work exposed a continuity gap: approved product and institutional positioning was present in demo materials but absent from the documents guiding marketing. The recovery combined conversation decisions, canonical docs, product evidence and the actual live baseline, then preserved audience-specific messaging and the Connected Atlas direction through HTML, Figma and browser review. The September 8 marketing draft remained a preview; later source checkpoints report PRs 183 and 184 merged. These are dated source claims, not a fresh production audit.

    6 steps1 record

    Images

    20 artifacts
    Aerial’s current public positioning — captured September 14, 2026. — Aerialimage

    Aerial’s current public positioning — captured September 14, 2026.

    Resources hub with glossary and industry timeline — current public page. — Aerialimage

    Resources hub with glossary and industry timeline — current public page.

    YC synthetic demo — Cryobank capacity: 23 recorded families, two reservations, and a 25-family policy — Aerialimage

    YC synthetic demo — Cryobank capacity: 23 recorded families, two reservations, and a 25-family policy

    YC synthetic demo — Cryobank correction review: disputed source value, reviewer, and preserved history — Aerialimage

    YC synthetic demo — Cryobank correction review: disputed source value, reviewer, and preserved history

    YC synthetic demo — Cryobank donor record: capacity, claim status, and connected recipient records — Aerialimage

    YC synthetic demo — Cryobank donor record: capacity, claim status, and connected recipient records

    YC synthetic demo — Cryobank medical notices: availability, acknowledgment, and assigned follow-up — Aerialimage

    YC synthetic demo — Cryobank medical notices: availability, acknowledgment, and assigned follow-up

    YC synthetic demo — Cryobank recipient record: Brooks family, donor, people, files, and coordination — Aerialimage

    YC synthetic demo — Cryobank recipient record: Brooks family, donor, people, files, and coordination

    YC synthetic demo — Donor field visibility: general audience and a clinic-only medical-history exception — Aerialimage

    YC synthetic demo — Donor field visibility: general audience and a clinic-only medical-history exception

    YC synthetic demo — Donor health: four shared updates, one private note, and a scheduled reminder — Aerialimage

    YC synthetic demo — Donor health: four shared updates, one private note, and a scheduled reminder

    YC synthetic demo — Family correction receipt: overdue review, source versions, and no final response — Aerialimage

    YC synthetic demo — Family correction receipt: overdue review, source versions, and no final response

    YC synthetic demo — Family health: family-authored updates and separately shared donor history — Aerialimage

    YC synthetic demo — Family health: family-authored updates and separately shared donor history

    YC synthetic demo — Family medical notice: a saved acknowledgment separate from social sharing — Aerialimage

    YC synthetic demo — Family medical notice: a saved acknowledgment separate from social sharing

    YC synthetic demo — Family–donor messaging: an accepted conversation leads to a shared health update — Aerialimage

    YC synthetic demo — Family–donor messaging: an accepted conversation leads to a shared health update

    YC synthetic demo — Institution partnerships: accepted relationships and separate case permissions — Aerialimage

    YC synthetic demo — Institution partnerships: accepted relationships and separate case permissions

    YC synthetic donor account: Evan Park’s connected network and capacity context. — Aerialimage

    YC synthetic donor account: Evan Park’s connected network and capacity context.

    YC synthetic family account: recorded totals stay distinct from identities visible to Maya. — Aerialimage

    YC synthetic family account: recorded totals stay distinct from identities visible to Maya.

    YC synthetic family account: separate sibling and donor sharing choices. No settings changed. — Aerialimage

    YC synthetic family account: separate sibling and donor sharing choices. No settings changed.

    YC synthetic family canvas: the Brooks family and connected donor sibling network. — Aerialimage

    YC synthetic family canvas: the Brooks family and connected donor sibling network.

    YC synthetic institutional account: Harbor Cryobank operations and follow-up. — Aerialimage

    YC synthetic institutional account: Harbor Cryobank operations and follow-up.

    YC synthetic institutional review: saved source discrepancy, identity uncertainty, and human decision point. — Aerialimage

    YC synthetic institutional review: saved source discrepancy, identity uncertainty, and human decision point.

    Notes

    3 artifacts

    Connected references

    Key dates

    2026-09-05
    Connected three-portal demo cast

    Synthetic family, donor, and cryobank records established a continuous product story.

    2026-09-06
    Institutional accountability delivery

    Recorded source milestone for permissions, capacity, notices, and review workflows.

    2026-09-12
    Marketing visual system release

    Lavender marketing direction merged in PR 183.

    2026-09-13
    Resources hub release

    Inline/modal videos and carousel refinements merged in PR 184.

    2026-09-14
    Current project record

    Current main 734411bb and fresh YC demo screens reviewed.