MaintainX-OS Enterprise Smart Manufacturing & CMMS Platform

MaintainX-OS — Enterprise Smart Manufacturing Execution System

MaintainX-OS is a modern, responsive manufacturing operations and maintenance frontend designed for production facilities, packaging lines, bottling operations, and industrial teams. It brings manufacturing execution, maintenance workflows, quality management, warehouse traceability, and executive analytics into a unified interface.

Built with React 19, Vite 8, React Router DOM v7, custom CSS, Lucide React, and Oxlint, MaintainX-OS features modular dashboards and role-oriented workflows for 12 operational perspectives.

Core Modules

Manufacturing Execution (MES): Production line monitoring, work-center status, OEE metrics, electronic batch record interfaces, and shop-floor operations.

Smart Maintenance (CMMS): Asset registries, maintenance work orders, preventive maintenance schedules, breakdown logs, troubleshooting workflows, and repeat-failure analytics.

Quality & HACCP: Quality inspections, critical control point (CCP) checks, batch holds, quarantine workflows, digital batch disposition interfaces, and RCA/CAPA tracking.

Warehouse & Traceability: Raw-material receipts, staging inventory, barcode workflows, lot genealogy, and finished-goods dispatch interfaces.

AI Operations Assistant: AI-assistance interface, vibration anomaly insight concepts, and predictive maintenance workflow presentation.

Executive Control Tower: Multi-plant KPIs, OEE comparisons, scrap variance analytics, production performance, and demand-forecasting views.

Multi-Tenant Administration: Tenant management, master-data catalogs, user administration, role-based access control, and migration workflow interfaces.

Technology Stack

• React 19

• Vite 8 with hot module replacement

• React Router DOM v7

• Custom responsive CSS design system

• Lucide React icons

• Oxlint code-quality tooling

• React Context API for application state and role-based workflows

Operational Roles

The role switcher provides 12 demo perspectives: Master Admin, System Administrator, Plant Manager, Maintenance Technician, Quality Specialist, Production Supervisor, Line Lead, Shop-Floor Operator, Warehouse/Logistics, Production Planner, CI Engineer, and Executive.

Setup

1. Install Node.js v18 or later; Node.js 20+ is recommended.

2. Install dependencies with npm install.

3. Copy .env.example to .env.

4. Run npm run dev to start the development server.

5. Run npm run lint for static code analysis.

6. Run npm run build to create the production bundle.

7. Run npm run preview to preview the production build.

API Integration & Deployment

The application supports configurable REST API integration through VITE_API_BASE_URL. It can be deployed as a static single-page application on compatible hosting platforms, including Vercel, Netlify, Cloudflare Pages, AWS S3 with CloudFront, or Nginx/Apache with SPA fallback routing.

Implementation note: The README describes a configurable frontend with mock data enabled by default. A live industrial IoT connection, production database, real predictive-AI engine, and verified regulatory-compliance implementation are not established by the supplied documentation and should not be advertised as operational without separate verification.