diff --git a/README.md b/README.md
index b05ef4c..74ed4cb 100644
--- a/README.md
+++ b/README.md
@@ -70,7 +70,7 @@ and the letter in the `#` part of the link never reaches the host's logs.
| Signal (SmartSpectra) | While writing | In the letter |
| --- | --- | --- |
-| Pulse rate (`cardio.pulseRate`, stable values only) | Live number and a trace drawn in the ink colour | Ink colour per character: calm navy near the writer's own median, warming toward red as the heart quickens, cooling as it settles. A beating heart in the margin keeps time. The closing card finds the quickest and steadiest sentences. |
+| Pulse rate (`cardio.pulseRate`, stable values only) | Live number, and each word takes its ink as you type it | Ink colour per character: iron-gall blue-black near the writer's own median, warming through claret to vermilion as the heart quickens, cooling to a clear blue-black as it settles. A pulse in the margin keeps time, and a heartline under the signature draws the whole letter's heart rate. The postscript finds the quickest and steadiest sentences. |
| Pulse wave (`cardio.arterialPressureTrace`) | Live trace | The wax seal: six seconds of the wave, wrapped into a ring and pressed into wax. Every seal is different. |
| Breathing (`breathing.upperTrace`, `breathing.rate`) | Breaths a minute | The paper rises and falls with the writer's breathing as it replays. |
| Smiles (`face.expression`, happy) | A small mark lights up | Words written while smiling glow softly. Optional. |
@@ -103,6 +103,7 @@ src/shared/
playback.js Replays the edits and maps the heart to ink
summary.js Quickest and steadiest sentences, smiles, words taken back
seal.js Draws the wax seal from the pulse wave
+ heartline.js Draws the letter's heart rate as one line of ink
sim-source.js Simulated SDK output for development and tests
test/ node --test: the core, plus the built pages in jsdom
```
diff --git a/docs/dev-post.md b/docs/dev-post.md
index 70343dd..70f7aed 100644
--- a/docs/dev-post.md
+++ b/docs/dev-post.md
@@ -11,15 +11,16 @@ A handwritten letter used to tell you things the words didn't: where the pen pre
**Heartwritten** brings it back with the one signal that never lies about how a sentence felt to write: your heartbeat.
-You write a letter on your laptop. While you type, SmartSpectra reads your pulse, breathing and smiles through the webcam. When you're done you seal it with a wax seal pressed from six seconds of your own pulse wave, so no two seals are alike.
+You write a letter on your laptop. While you type, SmartSpectra reads your pulse, breathing and smiles through the webcam, and each word takes the ink of the heartbeat that wrote it. When you're done you seal it with a wax seal pressed from six seconds of your own pulse wave, so no two seals are alike.
The person you send it to taps the seal, it cracks, and they watch your letter being written again at your real pace:
-- the **ink warms** toward red where your heart sped up, and settles back to navy as you calmed down
+- the **ink warms** from blue-black through claret to vermilion where your heart sped up, and cools again as you calmed down
- a small **heart in the margin beats** at your rate, sentence by sentence
- the **paper rises and falls** with your breathing
- words you wrote **while smiling glow**
-- **pauses** stay in, and the long ones are noted in the margin ("paused 14 seconds")
+- **pauses** stay in, and the long ones are noted in the margin beside the line ("paused 14 seconds")
+- under your signature, a **heartline** draws your whole heart rate across the letter
- if you allow it, they see the words you **typed and took back**
At the end, a card shows where your heart was quickest and where it was steadiest, with the sentences.
diff --git a/docs/screens/after-envelope.png b/docs/screens/after-envelope.png
new file mode 100644
index 0000000..c437277
Binary files /dev/null and b/docs/screens/after-envelope.png differ
diff --git a/docs/screens/after-letter-phone.png b/docs/screens/after-letter-phone.png
new file mode 100644
index 0000000..8be0bca
Binary files /dev/null and b/docs/screens/after-letter-phone.png differ
diff --git a/docs/screens/after-letter.png b/docs/screens/after-letter.png
new file mode 100644
index 0000000..7825673
Binary files /dev/null and b/docs/screens/after-letter.png differ
diff --git a/docs/screens/after-writer-write.png b/docs/screens/after-writer-write.png
new file mode 100644
index 0000000..4707a26
Binary files /dev/null and b/docs/screens/after-writer-write.png differ
diff --git a/docs/screens/before-envelope.png b/docs/screens/before-envelope.png
new file mode 100644
index 0000000..6631d42
Binary files /dev/null and b/docs/screens/before-envelope.png differ
diff --git a/src/reader/index.html b/src/reader/index.html
index 1f1f68f..ce8dcea 100644
--- a/src/reader/index.html
+++ b/src/reader/index.html
@@ -5,6 +5,7 @@
+
Heartwritten
@@ -17,35 +18,53 @@
Heartwritten
-
-
+
+
+
+
+
-
Tap the seal to open it.
-
Sample letter: the signals in it were simulated
+
Break the seal to read
+
A sample letter. The heartbeat in it was simulated.
This letter lives only in its link. Opening it sends nothing anywhere.