🏭 Warehouse Space Utilization Calculator with AI Insights

A professional, engineering-first web application designed to decouple Operational Capacity (Pallet Positions) from Strategic Capacity (Cubic Volume). This tool visualizes the efficiency gap in warehouse storage, helping supply chain leaders avoid premature facility expansion with AI-powered insights.

🔗 Launch Calculator

---

🎯 The Core Problem: “The Full but Empty Paradox”

Most Warehouse Management Systems (WMS) report capacity based on slots. If every rack position has a pallet, the WMS says the building is “100% Full.”

However, if those pallets are only 1 meter high, but the rack beams are set for 2 meters, you are storing 50% air. The building is operationally full, but strategically empty.

This application solves this by measuring two distinct metrics simultaneously:

1. Pallet Position Utilization: “Do I have a place to put the next truckload?”
2. Cubic Utilization: “Am I utilizing the vertical volume I am paying rent for?”

---

✨ Key Features

📊 Advanced Analytics

• Real-Time Computation: Instant recalculation of utilization percentages as dimensional inputs change
• Dual-Metric Dashboard: Simultaneous tracking of floor and cubic utilization
• Traffic Light System: Visual alerts for critical capacity thresholds
• Interactive Charts: Pie and bar charts for intuitive data visualization

🤖 AI-Powered Insights

• Safety Scoring: Real-time safety assessment (1–10) based on utilization metrics
• Smart Recommendations: AI-generated optimization strategies tailored to your warehouse data
• Risk Analysis: Automated identification of operational risks and bottlenecks
• Predictive Insights: Gemini AI analyzes patterns and suggests preventive measures

🛠 Professional Tools

• Unit Agnostic: Seamless toggle between Metric (m) and Imperial (ft) systems
• Auto-Save & Import: Save configurations and import data from CSV/Excel files
• PDF Export: Generate professional warehouse reports with one click
• Shareable Links: Create and share warehouse configurations via URL
• Responsive UI: Modern glassmorphism interface built with Tailwind CSS

---

🛠 Tech Stack

Built with a focus on type safety, performance, and component modularity.

Category	Technology	Usage
Core	React 18	Component architecture and state management
Language	TypeScript	Strict typing for dimensional logic and data structures
Build Tool	Vite	HMR and optimized production bundling
Styling	Tailwind CSS	Utility-first styling with custom typography
AI/ML	Google Gemini API	AI-powered warehouse insights and recommendations
Charts	Recharts	Interactive data visualizations (Pie/Bar charts)
Icons	Lucide React	Consistent SVG iconography
PDF Generation	jsPDF + html2canvas	Client-side PDF report generation

---

🚀 Getting Started

Prerequisites

• Node.js v18+ (Recommended v20 LTS)
• npm or yarn package manager

Installation

1. Clone the repository

   git clone https://github.com/Dev0psKing/warehouse-utilization-engine.git
   cd warehouse-utilization-engine

2. Install dependencies

npm install

3. Environment setup (for AI features)

echo "VITE_GEMINI_API_KEY=your_api_key_here" > .env.local

4. Get your API key from Google AI Studio

5. Run development server

npm run dev

6. Build for production

npm run build

📐 The Engineering Framework

1. Pallet Position Logic (2D)

Represents the slot availability on the warehouse floor.

Floor Utilization Formula

[ \text{Floor Utilization} = \frac{\text{Used Floor Area}}{\text{Effective Storage Area}} \times 100% ]

Status Indicators

• < 70% (Poor): Underutilized space
• 70–85% (Good): Optimal operation
• > 85% (Risk): Critical congestion and safety concerns

---

2. Cubic Volume Logic (3D)

Represents the volumetric efficiency of the entire building.

Cubic Utilization Formula

[ \text{Cubic Utilization} = \frac{\text{Inventory Volume}}{\text{Gross Building Volume}} \times 100% ]

Status Indicators

• < 50% (Low): Significant vertical space waste
• 50–75% (Optimal): Efficient vertical usage
• > 75% (Dense): Maximum density achieved

---

3. AI Analysis Framework

interface AIAnalysis {
  safetyScore: number;        // 1–10 safety rating
  summary: string;            // Overall assessment
  recommendations: string[];  // Actionable optimization steps
}

📁 Project Structure

warehouse-space-utilization-calculator/
├── src/
│   ├── components/           # React components
│   │   ├── AIInsights.tsx    # AI insights display
│   │   ├── ResultsSection.tsx
│   │   └── ...
│   ├── services/             # API services
│   │   └── geminiService.ts  # Gemini AI integration
│   ├── types.ts              # TypeScript interfaces
│   └── App.tsx               # Main application
├── public/                   # Static assets
├── .env.local                # Environment variables
└── package.json

👤 Author

Uwabor Collins: Building technical solutions for Supply Chain & Logistics GitHub: @Dev0psKing Project: Warehouse Space Utilization Calculator

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.