Kindlingfor peopleThe protocol siteThe specificationThe libraryThe Circular
KindlingAn open protocol for finding people
PreambleThe showcase

Shown, not told · shift 3 and shift 4

One Pool, many doors

A Pool is one file on its keeper’s own domain. Any app can read a public one, so the same people can come through many doors, and leaving an app is not leaving anyone. Here is one real Pool from the library, read three ways; one mentoring Pool in all three layers, as a page, as a file and as a card in four apps; and one person who switches apps and loses nothing.

Invented example. Wren, Jonah, Cormac and everyone in these panels are invented, and so are the apps, The Circular and the digest. The Pool file is real JSON: date-me-docs-cascadia.json. Nothing here is sent anywhere.

Art. IThree doors

One Pool, three readers.

The same 4 people from Wren’s List, a public Pool, read by three different readers. Each chose its own look and its own order of business. None of them holds the people.

Invented example

Roomful

Suits someone who wants one app for dating, and wants it to open full, reading the Pools they already joined.

RoomfulJonah’s room

Wren’s List Date-Me Docs: Cascadia

Public: anyone may read itKept by Wren Alvarez Signed in with OAuth

“Date-me docs from people in the Northwest, from British Columbia down the coast, who asked to be listed. A doc says who you are and what you want in your own words, on a page you keep. This list only points to it. No ranking, no scores, no paid placement.”

via Wren’s List

Wren Alvarez she/her

Signed in with OAuth

Portland, Oregon

Keeps a list of date-me docs from the Northwest. Reads every doc before she asks. Thinks a good doc says what you are like on a Tuesday.

wren-alvarez.example

Wren takes a first message from anyone verified.

via Wren’s List

Maya Lindgren she/her

Email verified

Seattle, Washington

Date-me doc. Nurse practitioner, 36, climbs on weekends, wants kids someday. My doc has a section called “Things I will not pretend to like.”

docs.example/d/maya-lindgren-date-me

Maya wants both people to say yes before a first message.

via Wren’s List

Ellis Nakamura he/him

Signed in with OAuth

Vancouver, British Columbia

Date-me doc. Urban planner, 39, divorced, good at soup and bad at small talk. Looking for someone to argue about transit with.

docs.example/d/ellis-nakamura-date-me

Ellis takes a first message from anyone verified.

via Wren’s List

Farah Siddiqui she/her

Email verified

Portland, Oregon

Date-me doc. Public-radio producer, 31. My doc links to three playlists and one strong opinion about breakfast.

docs.example/d/farah-siddiqui-date-me

Farah wants both people to say yes before a first message.

That is everyone: 4 people, in the order they said yes. Nobody is scored.

Open Roomful’s room

Invented example

An email digest

Suits someone who would rather not install anything. Email is the floor (§6.1): any Pool can reach any inbox.

From: Wren’s List <wren@wrenslist.example>

To: you

Date: Mon, 28 Sep 2026

Subject: Date-Me Docs: Cascadia: 4 people, this week

Date-Me Docs: Cascadia. Kept by Wren Alvarez Signed in with OAuth

public · universal-opt-in · everyone listed said yes.

> Date-me docs from people in the Northwest, from British Columbia down the coast, who asked to be listed. A doc says who you are and what you want in your own words, on a page you keep. This list only points to it. No ranking, no scores, no paid placement.

1. Wren Alvarez (she/her), Portland, Oregon

Signed in with OAuth

Keeps a list of date-me docs from the Northwest. Reads every doc before she asks. Thinks a good doc says what you are like on a Tuesday.

https://wren-alvarez.example

Wren takes a first message from anyone verified.

2. Maya Lindgren (she/her), Seattle, Washington

Email verified

Date-me doc. Nurse practitioner, 36, climbs on weekends, wants kids someday. My doc has a section called “Things I will not pretend to like.”

https://docs.example/d/maya-lindgren-date-me

Maya wants both people to say yes before a first message.

3. Ellis Nakamura (he/him), Vancouver, British Columbia

Signed in with OAuth

Date-me doc. Urban planner, 39, divorced, good at soup and bad at small talk. Looking for someone to argue about transit with.

https://docs.example/d/ellis-nakamura-date-me

Ellis takes a first message from anyone verified.

4. Farah Siddiqui (she/her), Portland, Oregon

Email verified

Date-me doc. Public-radio producer, 31. My doc links to three playlists and one strong opinion about breakfast.

https://docs.example/d/farah-siddiqui-date-me

Farah wants both people to say yes before a first message.

That is everyone: 4 people.

To write to someone, reply to their page’s address. To leave this Pool, send one message; it takes effect within 60 seconds.

Read §6.1, email is the floor

Invented example

The Circular

Suits someone who likes to read everyone at once, on a Monday. The Circular prints this Pool in its Personals section.

The CircularClassifieds · Personals · Monday, 28 September 2026

Date-Me Docs: CascadiaWren’s List

Kept by Wren Alvarez Signed in with OAuth

public · universal opt in · dating · date-me-doc

Date-me docs from people in the Northwest, from British Columbia down the coast, who asked to be listed. A doc says who you are and what you want in your own words, on a page you keep. This list only points to it. No ranking, no scores, no paid placement.

WL1-01

Wren Alvarez. Keeps a list of date-me docs from the Northwest. Reads every doc before she asks. Thinks a good doc says what you are like on a Tuesday.

she/her · Portland, Oregon · Reply to wren-alvarez.example

Signed in with OAuth

Takes messages from anyone verified.

WL1-02

Maya Lindgren. Date-me doc. Nurse practitioner, 36, climbs on weekends, wants kids someday. My doc has a section called “Things I will not pretend to like.”

she/her · Seattle, Washington · Reply to docs.example/d/maya-lindgren-date-me

Email verified

Takes messages from anyone verified, and only once both have said so.

WL1-03

Ellis Nakamura. Date-me doc. Urban planner, 39, divorced, good at soup and bad at small talk. Looking for someone to argue about transit with.

he/him · Vancouver, British Columbia · Reply to docs.example/d/ellis-nakamura-date-me

Signed in with OAuth

Takes messages from anyone verified.

WL1-04

Farah Siddiqui. Date-me doc. Public-radio producer, 31. My doc links to three playlists and one strong opinion about breakfast.

she/her · Portland, Oregon · Reply to docs.example/d/farah-siddiqui-date-me

Email verified

Takes messages from anyone verified, and only once both have said so.

4 ads. Nobody pays to run an ad.

Open The Circular’s Personals

The people, the charter and the consent are identical in all three; only the door differs.

Art. IIThree layers

One Pool, three layers.

A Pool is a page on its host’s site, a file anyone can read, and a card in any app that reads the file. Here is one that has nothing to do with dating: Cape Tarrow First-Gen Alumni, public and universal opt-in, kept by Bertrand Lomax at the alumni office of Cape Tarrow. It lists first-generation graduates who are glad to talk to students who are. Follow one of them, Cormac Doyle, through all three.

Layer 1 · the site

A page on the host’s own site

In the library, the alumni office has no site of its own, so its Pool is shown on Midspan’s home page, which reads it, and its files are served beside Midspan’s. Its well-known file lists it, so any app or registry can find it.

Cape Tarrow First-Gen Alumninot ours

Kept by Bertrand Lomax at Cape Tarrow since 1 April 2025 · public · alumni.capetarrow.example/pools/first-gen-alumni.json

  • Priya RamanEmail verified

  • Lorena CastañedaSigned in with OAuth

  • Maribel SotoSigned in with OAuth

  • Cormac DoyleEmail verified

    The person in the cards below.

  • Abebe GirmaSigned in with OAuth

Open the pageThe well-known file

Layer 2 · the data

A file anyone can read

The manifest: the charter, the curator, the tags, who can see it and how people join, and one entry per person, each with the record of their yes (§3.4). Here it is with Cormac’s entry, as the file has it.

first-gen-alumni.jsonthe manifest, without its entries

{
  "schema_version": "0.1",
  "id": "first-gen-alumni",
  "name": "Cape Tarrow First-Gen Alumni",
  "curator": [
    {
      "identity": "bertrand@mail.example",
      "display_name": "Bertrand Lomax",
      "verification_level": "oauth",
      "primary": true
    }
  ],
  "intent_tags": [
    "mentorship",
    "first-generation",
    "alumni",
    "careers"
  ],
  "visibility": "public",
  "consent_model": "universal-opt-in",
  "curator_contact": "alumni@capetarrow.example",
  "charter": "Graduates of Cape Tarrow College who were the first in their families to go to college, and who are glad to talk to students who are. Public on purpose, so any college on the coast can show students who is out there. Each person decides who may write to them. No recruiting, no selling, nothing to pay.",
  "geographic_scope": {
    "city": "Cape Tarrow",
    "country": "United States"
  },
  "governance_rules": "Anyone who finished a certificate or degree at Cape Tarrow College and was the first in their family to go to college may say yes to being listed. Any college or program may read this Pool; each person’s own rules decide who may write to them, and Cape Tarrow proposes nobody. Leave any time and your line is gone within a minute.",
  "messaging_preferences": {
    "block_list_subscriptions": [
      "https://protocol.kindling.foundation/blocklist.json",
      "https://thecircular.example/blocklist.json"
    ]
  },
  "status": "active",
  "created_at": "2025-04-01T12:00:00Z",
  "updated_at": "2026-09-12T15:00:00Z"
}

entries[3]one of 5, as the file has it

{
  "profile_url": "https://cormac-doyle.carrd.example",
  "parsed_profile": {
    "schema_version": "0.1",
    "profile_url": "https://cormac-doyle.carrd.example",
    "display_name": "Cormac Doyle",
    "pronouns": "he/him",
    "location": {
      "city": "Cape Tarrow",
      "country": "United States"
    },
    "intent_tags": [
      "mentorship",
      "first-generation",
      "forestry",
      "returning-student"
    ],
    "about": "Forestry technician with the state. First in my family to go to college; I went back at twenty-six. Good on field jobs, summer crews, and what to do when the first semester goes badly.",
    "contact_methods": [
      {
        "type": "email",
        "value": "cormac@mail.example",
        "label": "Kindling identity"
      }
    ],
    "verification": {
      "level": "email",
      "verified_at": "2025-10-19T16:30:00Z"
    },
    "messaging_preferences": {
      "accept_from": "verified",
      "no_cold_messages": true,
      "minimum_curator_verification": "email"
    },
    "kindling_noindex": false,
    "parsed_at": "2025-10-19T16:30:00Z",
    "parser": "kindling-parser/0.1.1"
  },
  "parsed_at": "2025-10-19T16:30:00Z",
  "consent_proof": {
    "handshake_id": "hs-cape-tarrow-first-gen-alumni-cormac",
    "accepted_at": "2025-10-19T16:30:00Z",
    "method": "email-link"
  },
  "verification_level": "email",
  "added_at": "2025-10-19T16:30:00Z",
  "added_by": "bertrand@mail.example"
}

Open the whole file

Layer 3 · the apps

A card in every app that reads it

Four apps read this Pool, each into a mode of its own: a deck, a room, a dial, a drawer. Each card names the Pool and links back to the page and the file. None of them shows an age, a gender or a picture, because the Pool’s file has no field for them and Cormac’s page adds none. These panels are drawn from the same entry, in each app’s own look; the apps show the same card, live.

Invented example

Face Up

Its Mentors deck, one card at a time

face upFirst-generation mentors

Cormac Doyle

Cormac

he/him · Cape Tarrow

Email verified

from Cape Tarrow First-Gen Alumni, kept by Bertrand Lomax

Graduates of Cape Tarrow College who were the first in their families to go to college, and who are glad to talk to students who are.

public · mentorship, first-generation, alumni, careers · Cape Tarrow Alumni · JSON

Their page has no picture, so Face Up deals the card as a letter, the way their Pool’s own site shows them.

Cormac takes no first messages until you both say yes. Say “Yes, ask to meet”, and if Cormac says yes back, you can write.

Its yes “Yes, ask to meet”, beside “Pass”, the same size. It stays in Face Up, in this deck only.

Open Face Up

Invented example

Heartwood

Its Mentorship room, the whole person

HeartwoodMentorship · Someone who went first

From Cape Tarrow alumni · Cape Tarrow First-Gen Alumni, kept by Bertrand Lomax Signed in with OAuth

“Graduates of Cape Tarrow College who were the first in their families to go to college, and who are glad to talk to students who are.”

mentorship · first-generation · alumni · careers · public · universal-opt-in

The same Pool in three layers: On Cape Tarrow Alumni’s site · As JSON · this card

Cape Tarrow Alumni shows Cormac in words, not a picture, and so do we. We never draw a face for someone who has not shown one.

Cormac Doyle he/him

Cape Tarrow

Email verified

In Cormac’s words

Forestry technician with the state. First in my family to go to college; I went back at twenty-six. Good on field jobs, summer crews, and what to do when the first semester goes badly.

Your yes stays in Heartwood. Cormac will see it if they open Heartwood; v0.1 has no message for a yes. A note would be held: Cormac asks for no first message until you have both said yes.

Its yes “Yes, a mentor”, beside “Not for me”, the same size. It stays in Heartwood, in this room only.

Open Heartwood

Invented example

Sundial

Its “A mentor” dial, one introduction at seven

SundialTonight · A mentor · 7:00 pm

cormac-doyle.carrd.example

No picture. Cape Tarrow Alumni draws none of its people, and a Pool’s file has no photo field (§2.5). This card is what the file holds.

Cormac Doyle

Email verified

He/him · Cape Tarrow

  • Only you are seeing this. Cormac is in Cape Tarrow First-Gen Alumni, on Cape Tarrow Alumni’s site, not in Sundial. Sundial shows him nothing about you.
  • Your yes stays in Sundial. Kindling v0.1 has no message that carries a yes, so nothing reaches Cormac unless you write.
  • You cannot write to Cormac here. No first message until both of you have said you would like to hear from each other.

Under the Pool

Cape Tarrow First-Gen Alumni Cape Tarrow Alumni

Graduates of Cape Tarrow College who were the first in their families to go to college, and who are glad to talk to students who are.

mentorship · first-generation · alumni · careers · public

Kept by Bertrand Lomax Signed in with OAuth

Its yes “Yes, as my mentor”, beside “Not this one”, the same size. It stays in Sundial, on this dial only.

Open Sundial

Invented example

Card Catalog

Its Mentors drawer, search first

Card CatalogMentors drawer · MEN

MEN 02 · Cape Tarrow First-Gen Alumni

Doyle, Cormac

he/him · Cape Tarrow

Email verified

“Graduates of Cape Tarrow College who were the first in their families to go to college, and who are glad to talk to students who are.”

Filed under 1. mentorship 2. first generation 3. alumni 4. careers · public

Kept by Bertrand Lomax · on Cape Tarrow Alumni · its JSON · this card

Cormac takes first messages only after you both say yes. Say yes first; if he says yes to yours too, you can write.

Its yes “Yes, a mentor”, beside “Set aside”, the same size. It stays in Card Catalog, in this drawer only.

Open Card Catalog

  • Bellows reads it. Public on purpose, so any college or program can show students who is out there. Each person decides who may write to them.
  • Familiar Faces reads it only for the people in it, and never suggests it to anyone else.
  • Threshold opens it only for its curator, Bertrand Lomax, as it does every Pool.
  • No app reads Midspan Students, the invite-only Pool beside it on Midspan’s site, even with the address.

The same in every door: the Pool and the person’s own rules.

The Pool’s name and charter, Cormac’s words, his verification in this Pool and his rule, no first message until both say yes (§7.2), are the same on the page, in the file and in all four cards. What changes is the door, and the words on its yes. A yes in one app stays there: v0.1 has no message for one (§6.3). The four apps follow a draft proposal, “Reading a Pool on its own terms”, which is not part of the spec yet; the apps page sets out its rules.

Art. IIISwitch apps

Switch apps, lose nothing.

Jonah Price is invented. He uses Roomful, and Wren has asked him onto her list. Switch his reader, answer Wren, then leave her Pool, and watch what changes. Only one thing ever does.

Invented example

Jonah Price he/him

Email verified

My date-me doc. Boatbuilder, 34. I cook on Sundays, read on the ferry, and I am looking for something that lasts. Write to me if you like early mornings.

docs.example/d/jonah-price-date-me

Jonah reads Kindling through

Wren’s request · Date-Me Docs: Cascadia

A no is remembered, and leaving is one message. His answer here also counts in Roomful.

What Jonah has
WhatNowAfter the last step
His pagehttps://docs.example/d/jonah-price-date-meHis own date-me doc. No app holds a copy.No steps yet
VerificationEmail verifiedNo steps yet
His PoolsNone yetNo steps yet
Open introductionFrom Wren’s List, waiting for his answer. Expires Oct 10, 6:00 PM UTC · 12 days leftNo steps yet
The readerRoomful: a room of name cards, grouped by the door each person came through.No steps yet

Copied between apps: nothing.

Nothing needs to be. His page is his own doc, the Pool is a file on Wren’s domain, and the request came to his email address (§5.2, §6.1). A reader only reads. Leaving a Pool is one message, processed within 60 seconds (§5.3), and every reader sees it at once, because there is only one Pool.

Art. IVA closed app

Why a closed app can’t do this.

Not because its makers are careless. Because of where the people live.

  1. In a closed app, the people are the product.

    If an app is worth only as much as the people in it, letting another app read them gives the worth away. So the room has one door, and the app owns it.

  2. Your profile lives in its database.

    You write it there, and your photos are uploaded there. Leaving means leaving them behind. In Kindling your page stays where you keep it, and photos are never copied.

  3. Leaving means starting over.

    The people you met there are reachable only there, so leaving the app is leaving them. In Kindling, leaving a Pool is one message, and leaving an app is not leaving anyone.

  4. Its messages stay inside it.

    A closed app keeps its own inbox. Kindling’s messages ride on email, so a conversation is in your inbox whichever reader you use.

  5. So nothing pushes it to let you go.

    An app paid while you look earns nothing when you leave. Kindling defines nothing to charge for between two people, so a reader can compete only on how well it treats you.

Shift 3, in plain wordsShift 4, in plain wordsThe library