Batch 6

Project library

Everything a person sees before the workbench opens: the cards that describe a build, the toolbar that narrows seven down to one, and the checklist that gets a kit ready. Half of this batch is not composition at all — it is the data that did not exist yet, and sixteen drawings.

The question the batch turns on is how much a card can say. The brief asks for nine fields and, in the same paragraph, for no bulky cards. Rule 3 asks that seven badges side by side read as one calm system rather than seven separate emphases. Seven cards in a grid is where those two sentences collide.

catalog.ts

The seven projects

The data the rest of the batch is built on — which did not exist in the repository until now.

The seven projects

Project catalogue
ProjectStatusTimeLevelStepsPartsConcepts
Breathing LampOne LED that swells and fades. It goes straight into the board — you do not even need the breadboard yet.Ready15 minBeginner433
Traffic LightThree LEDs on a breadboard: red, yellow, green, in an order that never slips.Ready20 minBeginner543
Motion Night LightA lamp that wakes when somebody walks past and settles back down when the hallway is quiet again.Ready25 minBeginner553
Plant GuardianA soil probe that watches how dry the pot is getting and lights up when the plant wants water.Ready35 minIntermediate654
Touchless Soap DispenserA pump that runs when a hand comes near, so nothing has to be touched to use it.Ready40 minIntermediate664
Smart Parking BarrierA barrier that notices the car coming, lifts to let it through and closes again behind it.Ready35 minIntermediate769

Same contract as the seven build steps: structure in lib/, words in the dictionary, both keyed by the same id. How long a build takes and which parts it needs are the same in every language; what it is called is not. Only Smart Parking Barrier is ready — the other six are honestly labelled preview, which is a product fact rather than a placeholder.

The component vocabulary

Microcontroller boardBreadboardSensorMicro servoLEDsResistors

Sensor is generic on purpose: distance, soil moisture, motion and temperature share one word and one mark, which keeps seven builds inside one small set instead of growing an icon per part. Push button is the one addition to the nine the inventory names — the reaction game is a person pressing a button when a light comes on, and calling that a sensor would be the kind of small lie that makes a legend untrustworthy.

What the builds teach

Digital pinsAnalogue readingsTrigger and echoPWM and servo controlLED polarityDistance measurementConditional logicMechanical calibrationTesting and debuggingThresholdsSerial outputTiming and reaction

Labels rather than sentences, because they sit in chips on a card and in a list on a detail page and both want the same words. A card shows the first three; the detail page shows all of them.

P-06

The component marks

Ten drawings for the ten things a build asks you to have — the vocabulary every other material in this batch is built out of.

The set

  • Microcontroller board
  • Breadboard
  • Sensor
  • Micro servo
  • LEDs
  • Resistors

Seen from above, like the canvas: the product has one point of view of a workbench and this is it. The colours are not a new palette — they are lifted verbatim from canvas/parts/, so the servo mark is the blue of the servo on the board and the resistor mark is the beige of the resistor beside it. A mark that used a different green from the board on the canvas would be a second opinion about the same object.

At every size it is used

24
32
40
48

24px inside a chip, 32 in a component strip, 40 in a checklist row, 48 on a detail page. The stroke is written in box units rather than pixels, so it stays a hairline at all four rather than thinning out at the bottom of the range.

On both grounds

A mark appears on white in a card and on sunken ground in a checklist row. Neither may swallow it — which is why the silhouettes carry a slightly heavier contour than the details inside them.

Why not the canvas parts

canvas/parts/ cannot be reused here and the reverse is also true. Those are scene parts on a real measuring system — a breadboard pitch is 2.54 mm, which is 10 scene units — and a drawing scaled down from there is unreadable at 44px. These are marks: fewer details, thicker relative strokes, no pin-level accuracy. Same hand, different distance.

P-02 · P-09

The seven scenes

One drawing per project — and the reason they are shown together rather than one at a time.

All seven, side by side

  • Breathing Lamp

  • Traffic Light

  • Motion Night Light

  • Plant Guardian

  • Touchless Soap Dispenser

  • Smart Parking Barrier

This is why they are reviewed as a set and never one at a time. Approving them individually is how seven drawings become seven styles: each one looks fine on its own, and only the row shows the drift.

Bespoke scenes were chosen over composing each one out of the component marks, so the risk that they end up as seven separate styles is real and had to be closed by hand. Three decisions do it, all taken before any of them was drawn. One ground: every scene is parts laid out on the workbench's own cutting mat, the same mat the canvas draws. One point of view: from above, always, so a pot is a circle and a bottle is a rounded rectangle with a cap. One level of detail: two to four recognisable parts and at most one mark for what the build does — an arc, a pool of light, a drop.

The hero is the same drawing

P-09 is not an eighth illustration. The detail page shows the barrier scene larger, so there is no second drawing that could one day disagree with the card about what this build looks like.

P-01

How much can a card say?

The question this batch turns on, built both ways with the same seven projects and left side by side.

The sharper way to put the choice is not more against less: A spends the space on what is in it, B on what it does. Both keep the fields no reasonable card drops — scene, name, duration, level, status, action. Look at the grids, not the single cards; every card looks fine on its own, and only the seven together answer the question.

In both directions the whole card is the link. Rule 1 reserves capsules for things you press, and a card is a surface you read, so it stays at 14px and never becomes one — but it is still clickable, so the action renders as text rather than as a button inside it. Two controls in one card is how a keyboard user ends up tabbing twice to reach one destination.

P-03 · P-04 · P-05 · P-07 · P-08 · P-10 · P-11

The rest of the library

The toolbar that narrows seven to one, the card for a build already under way, and the blocks a project detail page is made of.

Search and five filters

Try it: narrow by a component you do not own, or ask for something under 30 minutes. The count in the toolbar is the answer to the toolbar, so it sits inside it.

It filters for real. The narrowing lives in lib/projects/filter.ts as pure functions with no React in them, because an agent asked to find a build that uses a servo I already own calls the same code this toolbar calls. Nothing here is a new control either: the field is A-09, the popovers M-05, the checkboxes A-11's compact sibling, the ready toggle A-14. A filter button turns secondary once it is holding something back — the count alone would be one signal, and rule 7 asks for two.

The build already under way

The project card turned on its side, because this one answers a different question: not what is this but where was I. The progress indicator is A-15's compact variant, unchanged — a dashboard that invented a second way of saying 3/7 would have two of them to keep in step the first time the step count moved.

Getting a kit ready

Check off what you already have.

2 parts missing

What you'll learn

  • Digital pins
  • Trigger and echo
  • PWM and servo control
  • LED polarity
  • Distance measurement
  • Conditional logic
  • Mechanical calibration
  • Serial output
  • Testing and debugging

Build steps

  1. Check your kit2 min
  2. Learn the layout4 min
  3. Wire the distance sensor6 min
  4. Connect and mount the servo5 min
  5. Add status LEDs4 min
  6. Upload and calibrate8 min
  7. Run the full system test6 min

The checklist is A-11 fed, and the direction it uses — CB3 · Inventory row — was settled in Batch 1 for exactly this: a list you run down once before starting, counting stock rather than agreeing to terms. Nothing blocks. The line underneath reports and never warns, even at zero, because an unticked list still starts the build. The steps come from steps.ts — the same seven the workbench rail renders, so a preview cannot promise a build the workbench does not deliver.

Preview project

Preview project

This project is a preview. Its parts and its steps are real — what it does not have yet is a guided workbench of its own.

A sentence, not a box. This is the trap You can continue in guided demo mode set in Batch 2: the message's job is to set expectations calmly, and a warning-shaped container undoes that whatever the words say. Info rather than warning, too — a preview project is not a problem with the build, it is a fact about this release.

How it works

How it works

  1. Pick a real build
  2. Assemble with visual guidance
  3. Let your agent inspect and verify

Three numbered discs and a sentence each. No cards: this is the product talking about itself, and rule 4 gives surfaces to the user's input and to countable objects, never to output.