MassFlow
Plate VIColophon

Built on a realtime, AI-native stack.

MassFlow runs the full loop — a Next.js front end, a realtime Convex backend, and Claude-powered maintenance parsing and analytics — live in production at massflow.dev. Here is the apparatus behind it.

Fig. ω · ArchitectureRealtime + AI
4layers

Web · Data · Intelligence · Ops

A typed end-to-end pipeline — Convex codegen flows from the schema to the React hooks, with Claude Haiku 4.5 powering the in-product AI features.

Fig. α4
Stack layers
Fig. β17
Components catalogued
Fig. γ13.1k
Lines of TS / TSX
Fig. δ89
Source files
Plate VII — IXThe apparatus

The full stack of MassFlow.

Four layers — web, data, intelligence, and ops — as deployed in this repository revision.

17 components catalogued

Web layer·Plate VI

Frontend

Server Components, Server Actions, edge proxy auth.

  • 01Nx

    Next.js 16.2

    App Router · proxy.ts · use-action-state

  • 02Re

    React 19.2

    Server Components · transitions

  • 03Ts

    TypeScript 5

    Strict · Convex codegen typed end-to-end

  • 04Tw

    Tailwind v4

    PostCSS pipeline · oklch palette

  • 05Sh

    shadcn / Base UI

    Headless primitives · Lucide icons

  • 06Rc

    Recharts 3

    Wrapped in a ResizeObserver chart-frame

Data substrate·Plate VII

Backend

Realtime DB + typed queries, mutations, and actions.

  • 07Cv

    Convex 1.36

    Realtime DB · live useQuery · server actions

  • 08Sa

    Server actions

    AI gateway · session-checked, secret-gated

  • 09Df

    date-fns 4

    All time math, no Moment, no UTC drama

  • 10Zd

    Zod 4

    Form + AI-output validation

Intelligence·Plate VIII

AI

Plain-English maintenance parser and an analyst-mode report generator.

  • 11Ck

    Anthropic Claude Haiku 4.5

    Maintenance NL→JSON · Ask MassFlow analyst

  • 12Or

    OpenRouter

    LLM gateway · single API key, swappable models

  • 13Pr

    Prompt scaffolds

    Grounded on live event stream · refuses to invent data

Ops & shipping·Plate IX

Infrastructure

Production hosting and edge routing.

  • 14Vr

    Vercel

    Production at massflow.dev · ~27 s build

  • 15Gh

    GitHub

    ch3mistocampus / lcms-cmms · main

  • 16Px

    Edge proxy auth

    httpOnly cookie · proxy.ts gates every route

  • 17Cu

    Cursor IDE

    Composer agents (Opus 4.7) · multi-agent terminals

Plate XAcknowledgments

None of this works without the teams behind the tools.

Anthropic for Claude — Haiku 4.5 powers the in-product maintenance parser and analyst. Convex for letting us treat the database like a typed React hook. Vercel for turning each push into a live URL. Cursor for the agent-native IDE.

Fig. φBuild manifest
project
MassFlow · LCMS CMMS
domain
massflow.dev
region
Vercel · iad1 (default)
data
Convex · realtime
lines
13,131 TS / TSX
ai.model
claude-haiku-4.5

Continuous deployment through Vercel with Convex handling the live data plane.