Added enterprise network/job foundation with role checks and audit events.
Added WebSocket telemetry endpoint with subscription filtering, origin checks and message limits.
Added React/Tailwind realtime sensor chart with reconnect and backoff.
Added cloud database and Redis Streams operations guide with consumer-group monitoring.
Added automated Electron Windows build scripts for NSIS and Portable artifacts.

Verification

TypeScript check passed.
42 unit tests passed.
Production web/backend build passed.

Windows installer artifacts are generated by the Windows GitHub Actions workflow.

Assets 2

PipeFlow Pro Engine v1.0.0

Ali-Marandi released this 04 Aug 19:40

v1.0.0

d98533a

PipeFlow Pro Engine v1.0.0

Release Date: August 4, 2026

Overview

PipeFlow Pro Engine is a professional, web-based hydraulic calculator application designed for engineers performing pipe flow analysis using the Darcy-Weisbach equation. This initial release includes all core features for single-pipe and multi-segment network calculations with real-time visualization and comprehensive unit support.

✨ Key Features

Core Calculations

Darcy-Weisbach Equation Implementation - Accurate head loss calculations for circular pipes
Reynolds Number Calculation - Determines flow regime (laminar/transitional/turbulent)
Friction Factor Determination - Uses Swamee-Jain approximation for turbulent flow
Velocity Computation - Real-time velocity calculations from flow rate and diameter

Interactive Visualizations

Real-Time Pressure Drop Chart - Interactive Recharts visualization showing head loss vs. flow rate
Moody Diagram - Visual representation of friction factor across flow regimes
Live Chart Updates - Charts update automatically as parameters change

Unit System Support

SI (Metric) System - meters, m³/s, m/s, etc.
Imperial System - inches, feet, gallons/min, ft/s, etc.
Unit Toggle Button - One-click switching between systems
Persistent Preferences - Unit choice saved to browser localStorage

Material & Fluid Databases

Preset Fluids - Water (20°C), Oil (ISO VG 32), Air (20°C)
Preset Pipe Materials - Steel (commercial), PVC, Copper, Concrete
Custom Definitions - Users can add custom fluids and materials

Calculation Management

Calculation History - Save and name calculations for later reference
User-Scoped Storage - Each user's calculations stored securely
CSV Export - Download results for documentation and engineering reports

Authentication & Data Persistence

Manus OAuth Integration - Secure user authentication
Cloud Storage - Calculations persist across sessions and devices
User Profiles - Individual calculation history per account

Professional UI

Dark Theme - Navy background with cyan/teal accents
Responsive Design - Works on desktop, tablet, and mobile
Dashboard Navigation - Five main sections: Calculator, Moody Diagram, Pipe Network, History, About
Engineering Aesthetic - Clean, professional interface for technical users

📊 Technical Stack

Component	Technology
Frontend	React 19, TypeScript, Tailwind CSS 4
Backend	Express 4, tRPC 11, Drizzle ORM
Database	MySQL/TiDB
Authentication	Manus OAuth
Visualization	Recharts
Testing	Vitest

📐 Hydraulic Equations

Darcy-Weisbach Equation

h_f = f × (L/D) × (v²/2g)

Where:

h_f = head loss (m)
f = Darcy friction factor
L = pipe length (m)
D = pipe diameter (m)
v = flow velocity (m/s)
g = gravitational acceleration (9.80665 m/s²)

Reynolds Number

Re = (v × D) / ν

Where:

v = velocity (m/s)
D = diameter (m)
ν = kinematic viscosity (m²/s)

Friction Factor

Laminar (Re < 2300):

f = 64 / Re

Turbulent (Re ≥ 2300):

f = 0.25 / [log₁₀(ε/3.7D + 5.74/Re^0.9)]²

🧪 Testing

30+ Unit Tests - Comprehensive coverage of all calculation functions
Calculation Accuracy Tests - Validates Reynolds, friction factor, velocity, and head loss
Error Handling Tests - Validates input validation and error cases
All Tests Passing - 100% test pass rate

Run tests:

pnpm test

📦 Installation & Usage

Prerequisites

Node.js 22.13.0+
pnpm 10.4.1+

Setup

git clone https://github.com/Ali-Marandi/pipeflow-engine.git
cd pipeflow-web
pnpm install

Development

pnpm dev

Access at http://localhost:3000

Production Build

pnpm build
pnpm start

🚀 Deployment

The application is production-ready and can be deployed to:

Cloud Run (Google Cloud)
AWS Lambda
Azure Container Instances
Any Node.js hosting platform

📋 Unit Conversion Support

Parameter	SI	Imperial	Factor
Diameter	m	in	39.3701
Length	m	ft	3.28084
Flow Rate	m³/s	gal/min	15850.4
Velocity	m/s	ft/s	3.28084
Head Loss	m	ft	3.28084
Roughness	m	in	39.3701
Viscosity	m²/s	ft²/s	10.7639

🔄 Flow Regimes

Laminar: Re < 2300
Transitional: 2300 ≤ Re ≤ 4000
Turbulent: Re > 4000

📝 Documentation

README.md - Comprehensive technical documentation
CHANGELOG.md - Detailed version history
PIPEFLOW_README.md - Feature and architecture guide

🐛 Known Limitations

PDF export not yet implemented (CSV available)
Parallel pipe network calculations use simplified model
Temperature-dependent fluid properties not included in v1.0

🔮 Roadmap

v1.1 - PDF report generation, advanced network solver
v1.2 - Temperature-dependent fluid properties
v1.3 - Unit conversion for additional systems (CGS, etc.)
v2.0 - API access, batch processing, integrations

📞 Support

For issues, feature requests, or technical questions, please open an issue on GitHub.

📄 License

MIT License - See LICENSE file for details

Built with engineering precision. Powered by Darcy-Weisbach.

Repository: https://github.com/Ali-Marandi/pipeflow-engine
Live Demo: https://pipeflow-q6pkos9b.manus.space

Assets 2

Releases: Ali-Marandi/pipeflow-engine

Release list

v1.1.3

Uh oh!

PipeFlow Pro v1.1.0

Uh oh!

PipeFlow Pro v1.0.4 - Corrected Windows CI

Uh oh!

PipeFlow Pro v1.0.3 - Corrected Windows CI

Uh oh!

PipeFlow Pro v1.0.2 - Corrected Windows CI

Uh oh!

PipeFlow Pro v1.0.1 – Enterprise Realtime Foundation

Highlights

Verification

Uh oh!