Back to the shelf

043

Cleanroom Tracker

A 2D digital twin of each cleanroom: rounds planned and closed from outside, every step audit-ready.

Launched · Started June 2026 · System · Vibe-Coded

That's the whole thing.

The site's sound is off. The narration still plays.

This reading didn't load. The transcript is below.

Read the transcript

A cleanroom has rules. You cannot carry a device inside. Someone still has to plan the monitoring round and close it out. Every step has to stand up under audit. That problem was the start.

Cleanroom Tracker draws each room as a two-dimensional digital twin. Grade zones and monitoring points sit at true geometry, bound to live data. Operators plan and close plate-exposure rounds from outside, on a touch-first kiosk. Every change of state is logged. Reports print clean.

I vibe-coded it with AI in June twenty twenty-six, documentation first. It launched in July, live and in use, and has since scaled beyond the first facility. If this interests you, take a look.

Narrated in my own cloned voice, generated with ElevenLabs v4.

Cleanroom Tracker
No. 043

You cannot carry a device into a cleanroom. That one constraint is where this started.

I built Cleanroom Tracker for a pharma company’s environmental monitoring team, vibe-coded with AI starting June 2026. The problem was specific: monitoring rounds have to be planned, executed and closed without bringing a device inside the room. Every step, every decision, has to hold up under audit.

The answer was a two-dimensional digital twin. Each cleanroom is drawn to true geometry: rooms, grade zones and monitoring points, all bound to live data. From a touch-first kiosk outside the door, an operator plans a plate-exposure round with near-zero taps, then watches a countdown that cues exactly when to retrieve. The round moves through incubation reads and into QA review. The twin shows current status at a glance.

Every state change is logged. E-signatures are built in. Guardrails check operator qualification and media expiry before anything moves forward. Three printable PDF reports come out the other end.

I wrote the documentation first and the code second. That order shaped everything.

It launched in July 2026, live and in use. Since then it has scaled beyond the first facility through a per-facility pipeline.

The making

  • Next.js
  • React
  • TypeScript
  • PostgreSQL
  • Prisma
  • Tailwind CSS
  • Zustand
  • Vitest

01 · The problem

Before it existed

What hurt

Gowned operators cannot carry a phone or tablet into a classified cleanroom, yet someone must record which plates went down where, and when. The record was kept from memory afterwards.

Who uses it

  • Microbiology operators
  • Checkers
  • QC administrators
  • QA reviewers
  • 280commits in four months
  • 6facilities across two units
  • 39EM locations on the seeded twin
  • 5round states, in a fixed order

02 · The flow

6 steps, in the order they happen

  1. 01 / 06

    Sign in

    You
    Logs in with a role account, or a PIN on the corridor tablet
    It answers
    Opens only the facilities that account is assigned to, and logs the session
    A dark sign-in screen with the Cleanroom Tracker name and a green button
  2. 02 / 06

    Read the twin

    You
    Opens a facility and taps any pin on the plan
    It answers
    Shows rooms, grades and each plate position as live, coloured status
    A floor plan with grade zones and orange pins for plate, air and swab positions
  3. 03 / 06

    Plan a round

    You
    Picks the grade, plate type and shift, then the operator and media lot
    It answers
    Creates a planned round and runs the pre-entry checklist before T1
    Round management with grade, plate type and shift choices and a checklist
  4. 04 / 06

    Place and retrieve

    You
    Operator logs plates from the corridor, in bulk or per location
    It answers
    Calculates exposure from the SOP offsets; nothing is captured inside the zone
  5. 05 / 06

    Record the counts

    You
    Enters bacterial and fungal counts per plate after incubation
    It answers
    Unlocks only once the incubator-in time and the matching read are in
    A round timeline and a table of colony counts per plate location
  6. 06 / 06

    Check and print

    You
    A checker marks the round checked and opens the report
    It answers
    Renders a printable round record with the exposure window and every location
    A printed round record with exposure window, incubation record and a table of locations

03 · What was special

What it stands on

  1. Corridor-side by design

    Planning, placement, incubation hand-off and review all happen outside the door. No device crosses into classified space.

  2. Exposure is calculated

    Start is T1 plus entry and walk-to-first; end is T2 minus exit, from SOP offsets per grade. Nobody types a time inside.

  3. A round cannot skip a step

    Planned, started, retrieved, closed, checked – in that order, with a deviation or a skip recorded for every location.

The cleanroom stays clean, and the record stays honest.

Making-Of

Nothing electronic goes into a cleanroom. The record of what happened inside still has to be right.

The first commit, an initial build with the twin and its design system

  1. The world before

    Environmental monitoring in a sterile area means settle plates, air samplers and swabs at fixed positions. Operators in gowns cannot carry a device inside, so placement and retrieval times were noted afterwards, on paper.

  2. One day

    9 June 2026. The first commit landed a dark clinical design system, a digital twin of one facility and a first layer of play. Claude Code built it from the project bible written in Notion.

  3. Because of that

    1. The twin gained modes derived from real state – edit, idle, live round – and a redesigned printable round report (10 June).
    2. Rounds became a timeline with Place All and Retrieve All, and colony counts were gated on the incubator-in time (24 June).
    3. Modular reports with tabs, date filters and print views arrived (22 June).
    4. The system became multi-unit through a pull request, and the Unit 2 blocks were drawn one by one (15 to 24 July).
    5. The Validator role was renamed Checker, and an optional single sign-on was added (24 July, 2 August).
    6. A score bible and a lifecycle cue map gave the app a sound layer (6 August).
  4. Until finally

    Cleanroom Tracker is live and in use. The latest commits, on 25 September 2026, added a prep sheet, a media split, result entry and an incubation report.

  5. Since then

    Each new block arrives as its own twin, drawn to its plan and locked before operators use it.

The evidence Process, hands, and artifacts

Process

  1. Origin

    A corridor-side digital twin, not a device inside the zone

  2. Modes

    The twin shows edit, idle or live round from real state

  3. Reports

    Printable reports with tabs and date filters

  4. Rounds

    A round timeline; counts gated on incubation

  5. Units

    Multi-unit facility registry

  6. Twins

    All Unit 2 blocks drawn; Validator becomes Checker

  7. Sound

    Score bible and a lifecycle cue map

  8. Prep

    Prep sheet, media split, result entry, incubation report

Hands

Akshansh

  • Concept, the corridor-side rule and the product laws
  • Design direction and the project bible
  • Review of every order the agents built

Agents

  • Claude CodePrimary builder, order by order from the project bible
  • CursorExecuted briefs
  • Warp OzExecuted smaller briefs