Skip to content

A cost-effective platform using AI to predict equipment failures for small manufacturers, with easy integration and minimal setup.

License

Notifications You must be signed in to change notification settings

mobeen-asghar/MaintSaver

Repository files navigation

MaintSaver - AI-Powered Predictive Maintenance

Overview

MaintSaver is a comprehensive AI-powered predictive maintenance platform designed specifically for small manufacturers. Our solution helps reduce equipment downtime by 80% and maintenance costs by 50% through advanced machine learning algorithms and real-time monitoring.

Features

๐Ÿ”ฎ AI-Powered Predictions

  • Advanced machine learning algorithms analyze equipment patterns
  • Predict failures weeks in advance with high accuracy
  • Confidence scoring for each prediction

๐Ÿ“Š Real-Time Analytics

  • Monitor equipment health and performance metrics
  • Interactive dashboards with customizable views
  • Historical trend analysis and reporting

๐Ÿ”ง Equipment Management

  • Comprehensive equipment inventory tracking
  • Maintenance scheduling and history
  • Real-time status monitoring and alerts

๐Ÿšจ Smart Alerts & Notifications

  • Instant notifications for critical equipment issues
  • Customizable alert thresholds and preferences
  • Email and push notification support

๐Ÿ‘ฅ User Management

  • Role-based access control
  • Team collaboration features
  • Secure authentication with localStorage persistence

Technology Stack

  • Frontend: React 18 with TypeScript
  • Styling: Tailwind CSS with custom Neumorphic design system
  • Icons: Lucide React
  • Build Tool: Vite
  • State Management: React Context API
  • Data Persistence: localStorage
  • Authentication: Custom JWT-like token system

Design System

MaintSaver features a unique Neumorphic UI design that creates a soft, tactile experience:

  • Soft Shadows: Dual light/dark shadows create depth
  • Monochromatic Palette: Consistent gray-based color scheme
  • Tactile Interactions: Pressed button effects and hover states
  • Material Consistency: All elements appear carved from the same surface

Getting Started

Prerequisites

  • Node.js 18+
  • npm or yarn package manager

Installation

  1. Clone the repository:
git clone https://github.com/mobeen-asghar/MaintSaver.git
cd MaintSaver
  1. Install dependencies:
npm install
  1. Start the development server:
npm run dev
  1. Open your browser and navigate to http://localhost:5173

Demo Credentials

For testing purposes, you can use these demo credentials:

  • Email: Create free account
  • Password: Any passowrd

Or create a new account through the signup process.

Project Structure

src/
โ”œโ”€โ”€ components/          # Reusable UI components
โ”‚   โ”œโ”€โ”€ LandingPage.tsx  # Marketing landing page
โ”‚   โ”œโ”€โ”€ Layout.tsx       # Main application layout
โ”‚   โ””โ”€โ”€ ProtectedRoute.tsx # Route protection
โ”œโ”€โ”€ contexts/            # React Context providers
โ”‚   โ””โ”€โ”€ AuthContext.tsx  # Authentication state management
โ”œโ”€โ”€ pages/              # Application pages
โ”‚   โ”œโ”€โ”€ Analytics.tsx    # Analytics dashboard
โ”‚   โ”œโ”€โ”€ Dashboard.tsx    # Main dashboard
โ”‚   โ”œโ”€โ”€ Equipment.tsx    # Equipment management
โ”‚   โ”œโ”€โ”€ Login.tsx        # User login
โ”‚   โ”œโ”€โ”€ Predictions.tsx  # AI predictions
โ”‚   โ”œโ”€โ”€ Settings.tsx     # User settings
โ”‚   โ””โ”€โ”€ Signup.tsx       # User registration
โ”œโ”€โ”€ types/              # TypeScript type definitions
โ”‚   โ””โ”€โ”€ auth.ts         # Authentication types
โ””โ”€โ”€ utils/              # Utility functions
    โ””โ”€โ”€ storage.ts      # localStorage utilities

Features in Detail

Dashboard

  • Real-time equipment health overview
  • Recent alerts and maintenance schedules
  • Key performance indicators (KPIs)
  • Equipment status visualization

Analytics

  • Equipment efficiency trends
  • Downtime analysis
  • Cost savings tracking
  • Performance comparisons

Equipment Management

  • Add, edit, and remove equipment
  • Real-time status monitoring
  • Maintenance history tracking
  • Search and filtering capabilities

AI Predictions

  • Failure probability calculations
  • Recommended maintenance actions
  • Cost and downtime estimates
  • Confidence scoring

Settings

  • User profile management
  • Notification preferences
  • Security settings
  • Application preferences

Responsive Design

MaintSaver is fully responsive and optimized for:

  • Desktop: Full-featured dashboard experience
  • Tablet: Touch-optimized interface with collapsible navigation
  • Mobile: Streamlined mobile-first design

Data Management

All application data is managed through localStorage for demo purposes:

  • User authentication state
  • Equipment inventory
  • Maintenance records
  • User preferences
  • Application settings

Security Features

  • Secure authentication flow
  • Protected routes
  • Session management
  • Input validation
  • XSS protection

Browser Support

  • Chrome 90+
  • Firefox 88+
  • Safari 14+
  • Edge 90+

Contributing

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

License

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

Support

For support and questions:

Roadmap

  • Real-time WebSocket connections
  • Advanced reporting and exports
  • Mobile app development
  • Third-party integrations
  • Multi-tenant support
  • Advanced AI model training

MaintSaver - Keeping your equipment running smoothly with the power of AI.

About

A cost-effective platform using AI to predict equipment failures for small manufacturers, with easy integration and minimal setup.

Topics

Resources

License

Stars

Watchers

Forks

Languages