Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,9 @@ This repository is a place for collaborative design and design suggestions.

## Current revision

`index.html` is `Profile Page + Overview.dc.html`, the 2026-08-27 transfer from
Claude Design ("Alignment Asset Site - Ready for Dev"), byte-for-byte. Do not
hand-edit it — re-export from Design Composer and re-copy instead.
`index.html` started as `Profile Page + Overview.dc.html` (2026-08-27 Claude
Design transfer). Branch `lukas/contribution-profile-ia` is a hand-edited
working copy of that prototype — see `changelog.md` §7–§9.

See `changelog.md` for the design decisions behind this revision, and `CLAUDE.md`
for the copy rule (PLAA is **collected**, never "earned").
Expand Down
235 changes: 235 additions & 0 deletions changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -95,6 +95,241 @@ side, each with its own "Confirmed by Surus" line.

---

## 7. Lukas pass — contribution profile + IA (2026-09-08)

Working copy on `lukas/contribution-profile-ia` (`eca16fc`). This is the first
hand-edit of the 2026-08-27 Design Composer transfer. Home and Profile had
become two signed-in surfaces doing the same job; points and PLAA were mixed
on the same axes and columns; "snapshot" was the word for a calendar month.
The pass collapses the IA and makes the contribution profile PLAA-only.

### Information architecture

Previously the rail included Home, Profile, Overview, Activities,
Leaderboard, FAQ, Portfolio, and Kudos. Home and Profile both claimed to
be the member's starting point.

- **Home is off the rail.** Profile is the signed-in default. Prospects still
land on Overview (the old marketing Home markup is in the file but
unreachable). **Why:** Home and Profile were duplicative; one signed-in
surface is enough.
- **Overview absorbs FAQ and Portfolio & Holdings** behind a top toggle
(Introduction to PLAA / FAQ / Portfolio & Holdings). **Why:** those three
were sibling tabs for the same "what is PLAA / what does the trust hold"
question; a toggle keeps the rail short.
- **Leaderboard moves under Activities** as a third toggle (Activities /
Incentivized Network Asks / Leaderboard). Clicking the Activities rail
always opens Activities, not whichever toggle was last. **Why:** ranking
is a view of activity, not a destination of its own.
- **Activity tiers collapse by default** (Start here / Build momentum /
High-leverage). **Why:** the list was a wall of cards before you could
pick a thing to do.

### Contribution table

Previously the table mixed a points column with PLAA columns, called the
month a "snapshot", labelled the second stream "Infra rewards", and treated
Balance as a peer of Activities rather than a running total.

- **Snapshot → Period.** The column is "Points since mmm, dd" (e.g. Jul 1,
2026). "Snapshot" is stripped from the profile surface, not only the
header. **Why:** a snapshot is an event; this is a calendar month of
collection.
- **Table is PLAA-only.** Points never sit in their own column. Activities
show converted PLAA with the originating points as small supporting text
underneath. **Why:** mixing units in one row made every figure ambiguous.
PLAA is the answer; points are provenance.
- **Infra rewards → Rewards.** Shorter, and the Infra Member pill in the
hero already names the stream.
- **Balance → Ending balance.** It is derived from the three columns beside
it (Activities + Rewards − Redeemed), not a fourth independent number.
- **Redeemed shows dollar proceeds** at that period's clearing price, as
small supporting text under the PLAA — the same pattern as points under
Activities.
- **Column headers have short tooltips** explaining what the column is, with
a jump into Activities, Overview, or Portfolio so the header is also a
way into the related surface.
- **Click/hover an Activities, Rewards, or Redeemed cell** opens a
period-detail modal — the same job the blue-bar "snapshot summary" used
to do, attached to the number you are looking at.

### Chart

Previously a mixed points/PLAA series with the legend off the plot.

- **No mixed units.** The chart is a per-period PLAA waterfall: activities
and rewards as positive stacks, redeemed as a negative stack, each
segment labeled, net under the period. **Why:** one currency on the
plot; the stack is the period's story.
- **Cumulative ending-balance line kept** on a second axis. Axis titles sit
on the plot, above each vertical axis, rather than in a distant legend.
- **Series chips** hide/show Activities, Rewards, Redeemed, and Ending
balance so you can read the chart with or without a stream.
- **Drag across periods** reports relative and absolute change for the
selected range. **Click a segment** opens that period's detail modal.

### Copy and leftovers

- **"Points this snapshot" is off the profile hero.** The hero is a PLAA
balance; the period's points live in the table.
- **Snapshot history is no longer a profile toggle.** It duplicated the
contribution table under the chart.
- **Copy rule still holds:** PLAA and points are collected, never earned.
The (now-unreachable) Home CTA is **Collect PLAA now**, not "Earn PLAA
now" — even though the original note asked for earn wording. Flip if
Bill wants the exception.
- **Still in the file, unused:** old Home dashboard markup (signed-in
variants) and the old Snapshot history table. Easy to restore; not on
the rail.

---

## 8. Lukas pass 2 — profile / chart / table / Overview / Activities (2026-09-08)

`4c903a9`. Pass 1 shipped a working IA; this pass is interaction and
alignment — header, chart chrome, table states, Overview as a stable
shell, Activities as the place you see the current period.

### Profile header

Previously the name sat inset from "Member since", a decorative verified
check sat next to it, and Network Ambassador was a static badge with no
path to the next status.

- **Name left-aligns with "Member since".** One vertical edge for identity.
- **Verified check removed.** It had no purpose in this prototype (nothing
to verify against).
- **Network Ambassador becomes a status speedometer** toward the next
level. Invented ladder, flagged as invented: Contributor → Network
Ambassador → Steward → Fellow. Demo member (Alex) is at Ambassador, 17
activities short of Steward. **Why:** a badge that does not show how you
unlock the next one is just decoration. Rewrite the ladder if a real
one exists.

### Chart

- **Drag-delta sits in the plot**, not in a strip below it. You are looking
at the range; the number should be there too.
- **Axis titles align with the tick labels** on their own axis, rather
than floating in the margin.
- **Net gain/loss sits on the stacked bar** (not as a separate caption
underneath) and **follows series toggles** — hiding Rewards recomputes
the net. **Why:** the net is a property of what is currently shown, not
of the full dataset.
- **Hover a balance dot** for the exact ending-balance number. The line
was unreadable to the ones place without it.
- Titles: **Your PLAA over time** / **Your Contribution History**.

### Table

- **Points only on click** (this is reversed in §9 — it made closed
periods look empty). Rewards **top-aligned** so the PLAA figures share
a baseline with Activities and Redeemed.
- **PLAA bracket over the four PLAA columns is gone.** Everything in the
table is PLAA now; grouping was leftover from when a points column sat
beside them (§4).
- **Header tooltips are click-to-open** and no longer clip at the table
edge. Hover cut them off wherever the table ended.
- **Period is `mmm, yyyy`** (e.g. Jul, 2026), not `mmm dd, yyyy`.
**Why:** every row is a whole calendar month, so the day was noise.
(Pass 1's "Points since mmm, dd" was the first try at naming the
column; the month-year form is the one that stuck.)
- **Redeemed header jumps to Redeeming PLAA** on Overview → Introduction
to PLAA — the place that explains the mechanism, not a dead tooltip.
- **Current period (Aug) shows live points; PLAA and ending balance are
blurred.** **Why:** conversion is not known until the period closes.
Showing a calculated PLAA for an open month would be a fake number.
- **Redeemed total includes dollars and average clearing price**, so the
footer answers "how much did I actually take out?" without opening a
row.

### Overview

- **Header stays Overview** across the toggle, same pattern as Profile.
Flipping Introduction / FAQ / Portfolio no longer retitles the page.
- **Toggle order:** Portfolio & Holdings → Introduction to PLAA → FAQ.
Holdings first, because that is what a returning member comes for;
intro and FAQ are for orientation.
- **How-it-works boxes are tabs**, not four stacked sections:
Contribute → Who it's for; Collect → Points per Period; Convert →
Points → PLAA Conversion; Redeem (was Capitalize) → Redeeming PLAA.
**Why:** Capitalize implied a financial product. Redeem is the actual
action.
- **"Collect points this snapshot" CTA box removed** from the bottom of
Introduction to PLAA. It duplicated the Activities rail and still
said snapshot.
- **NAV:** hover spells out Net Asset Value and how it is calculated;
drag reports absolute and percent delta. Mock **circulating PLAA** and
**implied $/PLAA** so NAV ÷ tokens is visible. Circulating series is
invented mock data, flagged as such.

### Activities

- **Current-period spider chart moved here from Leaderboard.**
**Why:** the spider is "how does this period look for me", which
belongs with the activity list, not with a ranking of other people.

---

## 9. Lukas pass 3 — profile polish + NAV history (2026-09-08)

`35ae08f`. Pass 2 hid points behind a click and clipped several pieces of
chrome. This pass restores always-on points, puts chart hover and axis
titles inside the plot, sizes the status meter to the photo, and makes
the NAV chart a dilution read over a real history.

### Points (reverses §8)

Pass 2 hid points except on the current period (and on click of activity
PLAA). Closed rows then looked like they had no points.

- **Points stay visible on every period row.** They are supporting text
under Activities PLAA, always on.
- **Click the points (not the PLAA)** to open what they were collected
for. Closed periods open that period's activity list; the current
period opens the in-review summary. **Why:** the PLAA figure is the
converted result; the points are the work. Clicking the work should
show the work.

### Chart chrome

- **Axis titles left-align to the left axis and right-align to the right
axis**, clipped to the plot. Pass 2's titles overflowed the chart
bounds. Labels: **Period net (PLAA)** / **Ending balance (PLAA)**.
- **Hover tooltip is drawn as SVG** (the previous HTML overlay rendered
as an empty blue box). Hovering **the plot**, not only the ending-
balance dots, fills it (e.g. `Jul 1,711 PLAA`).

### Header and table chrome

- **Network Ambassador meter is 72px tall** — same top and bottom as the
profile photo. Pass 2's speedometer was a short pill next to a tall
photo.
- **Column-header bubbles right-align with the header text**; the caret
sits under the label, not the left edge of the cell. Headers are
right-aligned numbers, so a left-aligned bubble looked unattached.
- **Repeated page titles removed** on Overview, Activities, and Kudos.
The rail already names the tab; an in-page H1 repeating it was noise.
Profile keeps its own heading because the page is the person, not the
rail label.

### NAV history (Overview → Portfolio & Holdings)

Pass 2's NAV chart was a short recent window, so the two series could
not be compared and the dilution question was invisible.

- **Range is Jan 2025–Jul 2026.** Long enough for the slopes to mean
something.
- **NAV (solid) and issued PLAA (dashed) are both indexed to 100 at
start** so the two slopes are comparable on one axis. Raw NAV in
dollars and raw issued tokens cannot share a scale.
- **Issued rising faster than NAV is the dilution signal** — implied
$/PLAA falls. That is the point of the chart, not a side effect.
- **Hover and drag report both series.** Same interaction pattern as
the profile waterfall.

---

## For the doc

- Length: my call — aiming at ~2 pages, decisions and rationale, no exhaustive
Expand Down
Binary file added docs/pr/activities.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/pr/contribution-history.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/pr/overview-nav.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/pr/overview.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/pr/profile.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading