EasyAssets

Effortless Asset Management with QR Codes

EasyAssets is a powerful, modern tool designed to simplify the management of physical assets across large corporate buildings, factories, or organizations. Leveraging QR code technology, EasyAssets enables teams to track, update, and maintain assets seamlessly—right from their smartphones. Built with the robust MERN stack (MongoDB, Express.js, React, Node.js) and TypeScript, it ensures a scalable, type-safe, and high-performance solution for asset management.

---

✨ Key Features

• QR Code Scanning
  Attach a unique QR code to each asset and scan it to instantly access details or update its status in seconds.

• Asset Information
  Store essential data like asset name, location, purchase date, warranty details, and more—all centralized for easy access.

• Maintenance Tracker
  Schedule reminders and log repair or service history to keep assets in peak condition with minimal effort.

• Team Access
  Assign roles (e.g., admin, technician, viewer) to manage permissions and optimize team workflows.

• Dashboard & Reports
  Visualize asset status, flag items needing attention, and review historical data with an intuitive dashboard.

• Mobile-Friendly
  Scan and manage assets on the go using your smartphone—delivered as a lightweight Progressive Web App (PWA) for maximum convenience.

---

🚀 How It Works

1. Tag It: Place a QR code on each asset.
2. Scan It: Use your phone to scan and pull up asset details instantly.
3. Manage It: Update statuses, log maintenance, or review reports—all in real time.

EasyAssets streamlines asset management, boosts operational efficiency, and keeps your organization running like a well-oiled machine.

---

🛠️ Tech Stack

Built with cutting-edge technologies for reliability and scalability:

• MERN Stack:
  • MongoDB: Flexible NoSQL database for storing asset data.
  • Express.js: Lightweight backend framework for fast API development.
  • React: Dynamic, component-based frontend for a seamless user experience.
  • Node.js: Efficient runtime for handling server-side logic.
• TypeScript: Adds static typing for cleaner code and fewer bugs.
• Progressive Web App (PWA): Ensures a mobile-first, offline-capable experience.

---

⚙️ Project Setup

Prerequisites

Make sure you have:

• Node.js v14 or later
• npm or yarn

Installation

Clone the repository:

git clone https://github.com/NovaJam/EasyAssets.git
cd EasyAssets

Install dependencies:

npm install

or

yarn install

Environment Variables

Create .env files in both the server and client directories with the required configurations (e.g., MongoDB URI, JWT secret, etc.).

Run the Development Server

For the backend:

npm run dev

or

yarn dev

For the frontend:

npm start

or

yarn start

Visit http://localhost:3000 in your browser to get started.

📦 Deployment

To build the project for production:

npm run build

or

yarn build

This generates a build/ folder with optimized static files, ready for deployment.

🌟 Why EasyAssets?

• Simplifies tracking of physical assets in complex environments.
• Empowers teams with real-time updates and role-based access.
• Saves time and reduces errors with QR code automation.

*Built by Nova Designs Community | Idea by noobmaster