Build journal / week 9
Build journal: nested replies and a first live stream
The comment tree finally worked, a contribution improved the workflow, and a live conversation changed how I explained the next step.
This was the week the comment section stopped being a sketch and became a real part of the application. The hard part was not drawing a reply. The hard part was representing a conversation whose shape is unknown until the data arrives. Once the renderer treated each comment as the root of another possible list, the structure became manageable.
The recursive turn
The component now receives a collection, renders the visible details for each item, and hands the item's children back to itself. That one decision removed a pile of special cases. A reply is not a separate kind of screen. It is the same screen at a deeper position in the tree.
The visual treatment had to be restrained. A small amount of indentation communicates hierarchy, but too much makes the conversation unreadable. The layout stops increasing the offset after a few levels, so deep replies keep a stable left edge. The nesting is still present in the data and in the labels, just not in an ever shrinking column of text.
A contribution that improved the routine
A contributor added commit linting to the repository. That sounds like a small maintenance task, and it is, but it changes the quality of the project history. When commit messages follow a predictable form, the work is easier to scan and easier to discuss. Small process improvements compound in a project that is built in short weekly sessions.
The first live stream was another kind of contribution. Talking through the move to Nx forced me to explain why a workspace might help before showing how to create one. A live conversation exposes the gaps in your own understanding faster than a prepared article. It also made the project feel less like a private notebook and more like a shared experiment.
Notebook note: a recursive component is a small idea with a large effect. The same is true of a good commit history.
The next page
The plan for the following week was the podcast page. That work would test whether the existing card and list patterns could stretch to another content type. More importantly, it would show whether the application had a reusable visual language or a collection of one off screens. That question matters more than the next feature on the list.
Reference shelf
Selected external references for going deeper.