Skip to main content

Introduction to LabFlow

LabFlow is a multi-tenant Laboratory Information Management System for clinical laboratories, fronted by a public marketplace where patients find labs and laboratories apply to join. Both halves are the product. Where they meet, the lab-facing LIMS is the system of record and the marketplace reads from it.

It is live at labflow.aoneahsan.com, and it is built by the LabFlow team.

:::info This documentation describes what is built Every page here describes behaviour the application ships today. What is not built, and what is built but not yet released, is on Status and limits. :::

The two halves​

The public marketplace is open to anyone: the marketing and legal pages, a blog, comparison pages, a /sitemap and /feed derived from the route registry, and a laboratory directory where each listing shows what that laboratory declared about itself and a person on the LabFlow team reviewed.

The laboratory system is what a signed-in laboratory works in: patients, a coded test catalogue, panels and reference ranges, orders, specimens and their chain of custody, accessioning, labels, result entry, result review and release, and an operational dashboard. Around that spine sit billing, stock and equipment, quality control, compliance and audit, documents and workflow, appointments and home collection, reports and analytics, and the research, population and telemedicine registers.

Who uses it​

WhoWhere
Laboratory staff — owner, manager, pathologist, senior technician, technician, quality officer, phlebotomist, receptionist, billing clerkThe laboratory system, with a navigation rail built for each role
PatientsThe patient portal
CliniciansThe clinician portal
The LabFlow teamPlatform administration

Where to use it​

LabFlow is a web application at labflow.aoneahsan.com, responsive from phone to desktop. An Android app of the same application is on Google Play. There is no iOS app, no browser extension and no EMR add-on.

There is no public or REST API. LabFlow has no keyed API, no OpenAPI document and no webhook surface. It talks to its own database and a small set of server functions.

There is no live interface to an analyser, EMR or hospital system. HL7 v2 and FHIR R4 are exported and imported as files.

The stack, in one paragraph​

LabFlow is a React 19 + TypeScript single-page application built with Vite, routed by TanStack Router, with server state in TanStack Query, forms in react-hook-form + Zod, accessible primitives from React Aria Components, styling in Tailwind CSS v4, charts in D3, and every user-visible string routed through i18next. Its backend is Supabase — one hosted Postgres project, serving development and production both — where security is row-level security, deny-by-default on every table. Server-side work that needs more than a query runs in Supabase Edge Functions. File uploads go to FilesHub as private objects, never to the database. Errors go to Sentry, with the query string stripped. Firebase Hosting serves the built static files, and that is all Firebase does — there is no Firebase data tier, no Firestore, and no Firebase Authentication.

See Architecture for how those pieces fit.

Signing in​

Authentication is Google sign-in through Supabase, and LabFlow holds no password of its own. Your laboratory lists a Google account against your user record, and that account is your key — which also means the laboratory can withdraw it without waiting for anybody here. Whatever two-step verification your organisation already requires of a Google account applies before LabFlow is reached.

After the account comes the laboratory: an account can hold memberships in several, and the one you pick decides your role and everything you can see. Getting started walks through it.

On compliance, said honestly​

LabFlow is HIPAA-conscious. It is not HIPAA-compliant, and no software can be — compliance is a property of an organisation and its processes, not of a product. What LabFlow provides is the technical side: tenant isolation enforced in the database, least-privilege access, audit trails that are appended rather than edited, and error and analytics payloads that never carry patient data. The regulatory work — your risk assessment, your agreements, your staff training — remains yours.

LabFlow carries no FDA clearance, no CAP or CLIA accreditation and no SOC 2 attestation.

Who it is for​

Independent clinical laboratories and reference laboratories that want patients, orders, specimens and results in one system with a real chain of custody and a real release gate. If you need a live analyser or EMR interface, read Status and limits first — LabFlow does not have one.

How this documentation is organised​

  • Getting started — create an account, create or join a laboratory, find your way around.
  • User guide — one page per shipped area of the product, including the patient and clinician portals and platform administration.
  • Architecture — the database, tenancy and row-level security, and the record-integrity rules.
  • Status and limits — what is not built, and what is built but not yet released.
  • About LabFlow — how to contact the LabFlow team.

Next: Quick start →