Skip to content
BATCH IQ BATCH IQ

Getting Started

BATCH IQ is a simulated Quality Control platform that combines MES, LIMS, and an Agent Console UI on top of a shared Convex backend. Each frontend is its own app, but they share auth, scheduling logic, and data.

Prerequisites

Section titled “Prerequisites”
  • Node.js 18+
  • pnpm package manager
  • A Convex account (for backend)

Installation

Section titled “Installation”
  1. Clone the repository and install dependencies:
Terminal window
git clone <repository-url>
cd qc-test-agent
pnpm install
  1. Start everything with Turbo (recommended):
Terminal window
pnpm dev
  1. Or run individual apps:
Terminal window
# LIMS App
pnpm --filter @qc/lims-app dev


# MES App
pnpm --filter @qc/mes-app dev


# Agent Console
pnpm --filter @qc/agent-console dev
  1. Start the Convex backend:
Terminal window
pnpm --filter @qc/backend dev

This requires a CONVEX_DEPLOYMENT environment variable or local Convex setup.

Seeding Data

Section titled “Seeding Data”

Seed data lives in packages/backend/convex/seed_data/*.json. To seed the database:

Terminal window
pnpm --filter @qc/backend run seed

Update the JSON files and Convex schema before seeding if you need custom data.

Next Steps

Section titled “Next Steps”
  • Explore the Architecture to understand how the platform is structured
  • Check out individual app guides for LIMS, MES, and Agent Console