Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 

Repository files navigation

🎁 IMX Gift Store — Smart E-Commerce Solution

React Node.js PostgreSQL Capacitor

IMX Gifts is a premium, full-stack e-commerce platform designed for the personalized gifting market. Built with a focus on seamless user experience across web and mobile, it integrates complex business logic including wallet systems, automated OTP verification, and deep product customization.


🚀 Key Features

🛍️ Shopping Experience

  • Smart Product Catalog: Advanced filtering by category, price, and stock status.
  • Deep Personalization: Gift customization engine allowing users to add custom messages, photos, and select templates for special occasions.
  • Interactive Reviews: Modern 5-star rating system with real-time average score calculation.
  • Dynamic Wishlist: Save favorite items and move them to cart with a single click.

💳 Financial & Security

  • Virtual Wallet: Integrated Monnify wallet system for secure funding and instant checkout.
  • Automated OTP: Secure user verification via Gmail SMTP and Twilio (SMS).
  • Protected Routes: Secure authentication flow using JWT (JSON Web Tokens).

📱 Connectivity

  • Cross-Platform: Powered by Capacitor for high-performance Android and iOS native builds.
  • Network Resilient: Custom API client with interceptors for handling timeouts and session expiration gracefully.

🛠️ Technical Stack

Frontend

  • Framework: React.js 19
  • Icons: FontAwesome 7
  • Native: Capacitor (Android/iOS)
  • Styling: Vanilla CSS (Premium Glassmorphism & Modern UI)
  • State Management: Context API

Backend

  • Engine: Node.js & Express
  • Database: PostgreSQL with Sequelize ORM (Supabase)
  • Logging: Winston Production Logging
  • Caching: Redis
  • Security: Helmet, CORS, Express-rate-limit

📦 Physical & Database Architecture

The application uses a Hybrid Architecture combining the speed of a Node.js backend with the reliability of Supabase (Postgres).

  • Primary DB: PostgreSQL for Users, Products, Orders, and Reviews.
  • Storage: Local/Cloudinary (Configurable).
  • Messaging: Nodemailer for transactional emails and Twilio for SMS.

🧪 Quick Test Credentials

To preview the application without creating a new account, you can use the following live testing credentials:

  • Email: livetest@IMX.com
  • Password: LiveTest2026!

🔒 Security & Performance

  • Production-Ready Logging: Centralized error tracking with Winston.
  • Secure Headers: Implemented Helmet.js for protection against common web vulnerabilities.
  • API Optimization: Centralized Axios client with automatic Authorization header injection and standardized error handling.

📄 License

Distributed under the MIT License. See LICENSE for more information.


👨‍💻 Authors

Divine Okorie

Frontend Developer

Prosper Maxwell

Backend Developer


Tip

This project was audited for production readiness, ensuring all API endpoints are optimized and security headers are strictly enforced.

About

IMX Gift Store — A high-performance e-commerce solution built with React, Node.js, and Sequelize. Featuring Capacitor integration for cross-platform mobile support, Monnify payment gateway, and a robust OTP-based authentication system.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors