Skip to content

Debprasad77/Inventryx

Repository files navigation

🏒 Inventryx

Next-Generation Asset & Inventory Management System

Live Demo GitHub License

A powerful, feature-rich full-stack solution for managing assets, inventory, and maintenance operations with real-time analytics and intelligent automation.

🌐 Live Demo β€’ πŸ“– Documentation β€’ πŸ› Report Bug β€’ ✨ Request Feature


πŸ“Ή Project Preview

Inventryx Demo

Watch the full demo of Inventryx in action - Full walkthrough of all features


✨ Key Features

πŸ” Authentication & Security

  • Secure Authentication System with JWT tokens
  • Role-Based Access Control (RBAC) - Admin, Technician, User roles
  • Password Recovery with OTP verification
  • Email Verification for new registrations
  • Permission Management with granular access controls
  • Session Management with auto-logout

πŸ“Š Dashboard & Analytics

  • Real-time Dashboard with live statistics
  • Interactive Charts using Chart.js and Recharts
  • Asset Health Monitoring with status indicators
  • Maintenance Calendar with upcoming schedules
  • Activity Logs tracking all system operations
  • Quick Action Cards for rapid operations
  • Customizable Widgets based on user role
  • Export Dashboard Data (PDF/Excel)

πŸ“¦ Asset Management

  • Complete CRUD Operations for assets
  • Multi-Lab Support with floor-based organization
  • Asset Categorization by type and stream
  • Asset Tracking with unique IDs
  • Image Upload for asset documentation
  • QR Code Generation for quick asset identification
  • Asset Status Management (Active, Maintenance, Retired, Damaged)
  • Status Change History with audit trail
  • Bulk Import/Export capabilities
  • Advanced Search & Filters with multi-criteria
  • Asset Value Tracking for inventory worth
  • Warranty Management with expiry alerts
  • Purchase Date Tracking
  • Manufacturer Information

πŸ”§ Maintenance Management

  • Preventive Maintenance Scheduling
  • Maintenance Request System
  • Technician Assignment with notifications
  • Maintenance History Tracking
  • Status Updates (Pending, In Progress, Completed, Cancelled)
  • Cost Tracking for maintenance operations
  • Recurring Maintenance setup
  • Email Notifications for upcoming maintenance
  • Mobile-Responsive maintenance forms
  • Maintenance Reports generation

πŸ’¬ Communication System

  • Internal Messaging between users
  • Message Categories (Info, Warning, Alert)
  • Read/Unread Status tracking
  • Message Search functionality
  • Compose & Reply capabilities
  • Message Deletion with confirmation
  • Contact Form for external queries
  • Admin Message Management
  • Real-time Notifications for new messages

πŸ‘₯ User Management

  • User Registration with email verification
  • Profile Management with avatar upload
  • Role Assignment (Admin, Technician, User)
  • User Activity Tracking
  • Permission Requests system
  • Credential Management
  • Add/Edit/Delete Users (Admin only)
  • User Search & Filters
  • Technician Management separate interface

πŸ“Š Reports & Analytics

  • Comprehensive Report Generation
  • PDF Export with custom templates
  • Excel Export with formatted data
  • Date Range Selection for reports
  • Asset Reports by status, lab, category
  • Maintenance Reports with cost analysis
  • Activity Reports with user logs
  • Custom Report Filters
  • Downloadable Charts & Graphs

πŸ”” Notification System

  • Real-time Notifications with bell icon
  • Notification Types (Info, Warning, Error, Success)
  • Unread Count Badge
  • Mark as Read/Unread
  • Delete Notifications
  • Auto-notifications for:
    • Asset status changes
    • Maintenance schedules
    • New messages
    • Permission requests
    • System alerts

🎨 UI/UX Features

  • Fully Responsive Design (Mobile, Tablet, Desktop)
  • Dark/Light Mode Support
  • Animated Backgrounds with Framer Motion
  • Smooth Transitions and micro-interactions
  • Loading States with skeletons
  • Toast Notifications for user feedback
  • Modal Dialogs for confirmations
  • Sidebar Navigation with collapse
  • Search Bar in navigation
  • Breadcrumb Navigation
  • Pagination for large datasets
  • Drag & Drop file uploads
  • Form Validation with Formik
  • Date Pickers for scheduling

πŸ›‘οΈ Additional Features

  • Activity Logging for all operations
  • Audit Trail for compliance
  • Data Export/Import capabilities
  • Backup System integration ready
  • API Rate Limiting protection
  • Error Handling with user-friendly messages
  • Form Auto-save drafts
  • Keyboard Shortcuts support
  • Print-friendly layouts

πŸ› οΈ Tech Stack

Frontend

React Vite TailwindCSS React Router Chart.js Framer Motion

Backend

Node.js Express MongoDB JWT

Deployment

Vercel MongoDB Atlas

Frontend Technologies:

  • βš›οΈ React 19 with Hooks & Context API
  • ⚑ Vite for lightning-fast builds
  • 🎨 TailwindCSS 4 for modern styling
  • 🎭 Framer Motion for animations
  • πŸ“Š Chart.js & Recharts for data visualization
  • πŸ”„ Axios for API calls
  • πŸ“ Formik for form management
  • πŸ—“οΈ React Date Range for date selection
  • 🎯 React Icons & Lucide Icons
  • 🍞 React Toastify for notifications
  • πŸ“± React Responsive for device detection

Backend Technologies:

  • 🟒 Node.js & Express.js
  • πŸƒ MongoDB with Mongoose ODM
  • πŸ” JWT for authentication
  • πŸ“§ Nodemailer for emails
  • πŸ“ Multer for file uploads
  • πŸ”’ Bcrypt for password hashing
  • 🌐 CORS enabled

Development Tools:

  • πŸ“¦ npm for package management
  • πŸ” ESLint for code quality
  • πŸ”„ Concurrently for running services
  • πŸ—‚οΈ dotenv for environment variables

πŸ§ͺ Default Login Credentials

Use these test accounts for quick exploration.

Email: [email protected]
Password: testuser

πŸš€ Quick Links

Resource Link
🌐 Live Application https://inventryx.vercel.app
πŸ“š Deployment Guide DEPLOYMENT.md
πŸ“‹ Project Setup START_HERE.md
πŸ› Issues & Bugs GitHub Issues
πŸ’‘ Feature Requests GitHub Issues

πŸ“Έ Screenshots

Dashboard

Dashboard

Asset Management

Assets

Maintenance Tracking

Maintenance

Reports & Analytics

Reports


πŸ“ Project Structure

Inventryx/
β”œβ”€β”€ πŸ“ api/                      # Vercel serverless functions
β”‚   └── index.js                 # API entry point
β”œβ”€β”€ πŸ“ server/                   # Backend application
β”‚   β”œβ”€β”€ index.js                 # Server entry point
β”‚   β”œβ”€β”€ πŸ“ models/               # MongoDB schemas
β”‚   β”‚   β”œβ”€β”€ Asset.js
β”‚   β”‚   β”œβ”€β”€ User.js
β”‚   β”‚   β”œβ”€β”€ Maintenance.js
β”‚   β”‚   β”œβ”€β”€ Message.js
β”‚   β”‚   β”œβ”€β”€ Notification.js
β”‚   β”‚   β”œβ”€β”€ Log.js
β”‚   β”‚   └── ...
β”‚   β”œβ”€β”€ πŸ“ routes/               # API endpoints
β”‚   β”‚   β”œβ”€β”€ auth.js
β”‚   β”‚   β”œβ”€β”€ asset.js
β”‚   β”‚   β”œβ”€β”€ maintenance.js
β”‚   β”‚   β”œβ”€β”€ messages.js
β”‚   β”‚   └── ...
β”‚   β”œβ”€β”€ πŸ“ middleware/           # Auth & validation
β”‚   β”œβ”€β”€ πŸ“ utils/                # Helper functions
β”‚   └── πŸ“ uploads/              # File storage
β”œβ”€β”€ πŸ“ src/                      # Frontend React app
β”‚   β”œβ”€β”€ App.jsx                  # Main component
β”‚   β”œβ”€β”€ main.jsx                 # Entry point
β”‚   β”œβ”€β”€ πŸ“ pages/                # Route pages (20+ pages)
β”‚   β”‚   β”œβ”€β”€ Dashboard.jsx
β”‚   β”‚   β”œβ”€β”€ LabAssets.jsx
β”‚   β”‚   β”œβ”€β”€ Maintenance.jsx
β”‚   β”‚   β”œβ”€β”€ Reports.jsx
β”‚   β”‚   └── ...
β”‚   β”œβ”€β”€ πŸ“ components/           # Reusable components
β”‚   β”‚   β”œβ”€β”€ Navbar.jsx
β”‚   β”‚   β”œβ”€β”€ Sidebar.jsx
β”‚   β”‚   β”œβ”€β”€ Footer.jsx
β”‚   β”‚   β”œβ”€β”€ πŸ“ forms/           # Form components
β”‚   β”‚   β”œβ”€β”€ πŸ“ modals/          # Modal dialogs
β”‚   β”‚   β”œβ”€β”€ πŸ“ messaging/       # Message components
β”‚   β”‚   └── πŸ“ ui/              # UI components
β”‚   β”œβ”€β”€ πŸ“ context/              # React Context
β”‚   β”‚   β”œβ”€β”€ AuthContext.jsx
β”‚   β”‚   └── NotificationContext.jsx
β”‚   └── πŸ“ utils/                # Frontend utilities
β”‚       β”œβ”€β”€ permissions.js
β”‚       β”œβ”€β”€ reportGenerator.js
β”‚       └── exportReportGenerator.js
β”œβ”€β”€ πŸ“ public/                   # Static assets
β”œβ”€β”€ vercel.json                  # Vercel config
β”œβ”€β”€ vite.config.js               # Vite config
└── package.json                 # Dependencies

🎯 Use Cases

  • 🏫 Educational Institutions - Manage lab equipment and assets
  • 🏒 Corporate Offices - Track IT assets and inventory
  • 🏭 Manufacturing Units - Equipment maintenance scheduling
  • πŸ₯ Healthcare Facilities - Medical equipment management
  • πŸͺ Retail Stores - Inventory and asset tracking
  • πŸ”¬ Research Labs - Scientific equipment management

🌟 Why Inventryx?

βœ… Comprehensive Solution - All-in-one asset management platform
βœ… User-Friendly Interface - Intuitive design for all skill levels
βœ… Real-time Updates - Stay informed with live notifications
βœ… Scalable Architecture - Grows with your organization
βœ… Secure & Reliable - Enterprise-grade security features
βœ… Mobile Responsive - Access from any device, anywhere
βœ… Cost-Effective - Open-source and free to use
βœ… Easy Deployment - One-click deploy to Vercel


πŸ‘¨β€πŸ’» Developer

Debprasad

GitHub Email

Full Stack Developer | MERN Stack Specialist | Open Source Enthusiast


🀝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page.


⭐ Show Your Support

If you find this project helpful, please consider giving it a ⭐ on GitHub!


πŸ“ž Support & Contact


Made with ❀️ by Debprasad

Β© 2025 Inventryx. All rights reserved.

Simplifying Asset Management, One Click at a Time