Skip to content

saky-semicolon/EzHome-e-commerce-Application

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

10 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

EzHome - Smart Home E-commerce Platform

Version License Bootstrap

🏠 Overview

EzHome is a comprehensive e-commerce platform specializing in smart home automation products and IoT devices. The platform provides a complete solution for customers to browse, purchase, and manage smart home technologies with an intuitive user interface and robust administrative features.

🌟 Key Features

  • Smart Product Catalog: Comprehensive collection of IoT devices, smart sensors, and home automation products
  • Package Deals: Starter, Premium, and Elite smart home packages for different needs
  • User Management: Complete authentication system with role-based access control
  • Shopping Cart: Full-featured cart with local storage persistence
  • Order Management: Advanced order tracking and management system
  • Admin Dashboard: Comprehensive administrative panel with analytics
  • Responsive Design: Mobile-first responsive design using Bootstrap 5
  • Product Management: Advanced inventory and product management tools

πŸ“‚ Project Structure

EzHome e-commerce Application/
β”œβ”€β”€ EzHome v1.0.0/          # Initial release version
β”œβ”€β”€ EzHome v2.0.0/          # Major update with enhanced features
β”œβ”€β”€ EzHome v2.1.0/          # Latest version with improvements
β”‚   └── EzHome/
β”‚       β”œβ”€β”€ index.html      # Homepage with product showcase
β”‚       β”œβ”€β”€ about.html      # Company information
β”‚       β”œβ”€β”€ contact.html    # Contact form and information
β”‚       β”œβ”€β”€ admin.html      # Administrative dashboard
β”‚       β”œβ”€β”€ product.html    # Individual product pages
β”‚       β”œβ”€β”€ checkout.html   # Checkout process
β”‚       β”œβ”€β”€ orders.html     # Order management
β”‚       β”œβ”€β”€ help.html       # Help and FAQ section
β”‚       β”œβ”€β”€ css/
β”‚       β”‚   └── styles.css  # Custom styling and animations
β”‚       β”œβ”€β”€ js/
β”‚       β”‚   β”œβ”€β”€ app.js      # Main application logic
β”‚       β”‚   β”œβ”€β”€ auth.js     # Authentication system
β”‚       β”‚   β”œβ”€β”€ cart.js     # Shopping cart functionality
β”‚       β”‚   β”œβ”€β”€ products.js # Product database
β”‚       β”‚   └── ...         # Additional modules
β”‚       └── images/         # Product images and assets
└── README.md               # This file

πŸš€ Quick Start

Prerequisites

  • Modern web browser (Chrome, Firefox, Safari, Edge)
  • Local web server (optional but recommended)

Installation

  1. Clone the repository:

    git clone https://github.com/saky-semicolon/EzHome-e-commerce-Application.git
    cd EzHome-e-commerce-Application
  2. Navigate to the latest version:

    cd "EzHome v2.1.0/EzHome"
  3. Start a local server (recommended):

    # Using Python 3
    python -m http.server 8000
    
    # Using Node.js
    npx serve .
    
    # Using PHP
    php -S localhost:8000
  4. Open your browser and navigate to:

    http://localhost:8000
    

Direct File Access

Alternatively, you can open index.html directly in your browser, though some features may be limited without a local server.

πŸ›οΈ Product Categories

Smart Home Packages

  • Starter Package ($499): Perfect for small apartments and beginners

    • Echo Hub Essential
    • 4x Smart LED Bulbs
    • 2x Smart Outlets
    • Mobile App Access
  • Premium Package ($999): Ideal for medium to large homes

    • Echo Hub Standard
    • Smart Thermostat Pro
    • 8x Smart LED Bulbs
    • Smart Security Camera
    • Smart Door Lock
  • Elite Package ($1,999): Ultimate smart home experience

    • All Premium features
    • Smart Outdoor Camera
    • Sky Blinds Automated
    • Smart Irrigation System
    • 24/7 Premium Support

Individual Products

  • Voice Assistants: Echo Hub series with smart home control
  • Lighting: Smart LED bulbs with color changing capabilities
  • Security: Cameras, door locks, motion sensors
  • Climate: Thermostats, air purifiers, fans
  • Automation: Sensors, switches, irrigation controllers

πŸ‘₯ User Roles & Access

Customer Features

  • Browse product catalog
  • Add items to cart
  • User registration and login
  • Order tracking
  • Product reviews and ratings

Admin Features

  • Product management (CRUD operations)
  • Order management and tracking
  • User management
  • Analytics dashboard
  • Inventory management
  • System settings and maintenance

Default Admin Credentials

Username: admin
Password: *****

πŸ› οΈ Technical Features

Frontend Technologies

  • HTML5: Semantic markup and modern web standards
  • CSS3: Custom styling with animations and responsive design
  • Bootstrap 5.3.0: Responsive framework and components
  • JavaScript/jQuery: Interactive functionality and AJAX
  • Font Awesome 6.0: Icon library

Key JavaScript Modules

Core System

  • app.js: Main application initialization and global functions
  • auth.js: User authentication and session management
  • products.js: Product database and catalog management

E-commerce Features

  • cart.js: Shopping cart functionality with local storage
  • checkout.js: Order processing and payment interface
  • orders.js: Order management and tracking system

Administrative Tools

  • admin.js: Administrative dashboard and analytics
  • product-management.js: Inventory and product CRUD operations
  • staff.js: Staff management interface

User Experience

  • animations.js: UI animations and transitions
  • search.js: Product search and filtering
  • ratings.js: Product review and rating system

Data Storage

  • Local Storage: Client-side data persistence for:
    • User sessions and preferences
    • Shopping cart contents
    • Product catalog cache
    • Order history
    • Administrative settings

Responsive Design

  • Mobile-first approach
  • Breakpoints for all device sizes
  • Touch-friendly interfaces
  • Optimized images and loading

πŸ“± Mobile Features

  • Progressive Web App (PWA) capabilities
  • Touch-optimized interface
  • Mobile-specific navigation
  • Responsive product galleries
  • Mobile checkout flow

πŸ”§ Development Features

Image Management

The platform includes a comprehensive image upload system:

  • Upload Helper Script: upload-image.sh for easy file management
  • Image Upload Guide: Detailed instructions in IMAGE_UPLOAD_GUIDE.md
  • Supported Formats: JPG, PNG, GIF, WebP
  • File Size Limit: 5MB maximum
  • Auto-resize and optimization

Testing & Debugging

  • Built-in error handling and logging
  • Admin diagnostic tools
  • Sample data generation for testing
  • Browser console debugging support

🎨 Customization

Styling

The css/styles.css file contains:

  • Custom CSS variables for theming
  • Animation keyframes and transitions
  • Responsive breakpoints
  • Component-specific styling

Configuration

Key configuration options:

  • Product categories and specifications
  • Payment methods and shipping options
  • Email templates and notifications
  • Security settings and access controls

πŸ“Š Analytics & Reports

The admin dashboard provides:

  • Sales analytics and trends
  • Product performance metrics
  • User behavior insights
  • Inventory reports
  • Order fulfillment statistics

πŸ” Security Features

  • Client-side input validation
  • XSS protection measures
  • Secure session management
  • Role-based access control
  • Data encryption for sensitive information

πŸš€ Performance Optimizations

  • Lazy loading for images
  • Minified CSS and JavaScript
  • Caching strategies
  • Optimized asset delivery
  • Progressive enhancement

πŸ“‹ Browser Support

  • Chrome 90+
  • Firefox 88+
  • Safari 14+
  • Edge 90+
  • Mobile browsers (iOS Safari, Chrome Mobile)

🀝 Contributing

We welcome contributions! Here's how you can help:

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

Development Guidelines

  • Follow existing code style and conventions
  • Test thoroughly across different browsers
  • Update documentation as needed
  • Ensure responsive design compatibility

πŸ“ž Support & Contact

Company Information

EzHome Trading Pte Ltd

  • Address: 27 Trade Hub Boulevard, #04-144, Singapore 520027
  • Phone: +65 6888 2727
  • Customer Service: +65 6888 2700
  • Email: info@ezhome.com.sg
  • Business Hours: Monday to Friday, 9:00 AM – 6:00 PM

Online Support

πŸ“œ License

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

πŸ”„ Version History

v2.1.0 (Current)

  • Enhanced user interface with improved animations
  • Advanced product management features
  • Improved mobile responsiveness
  • Better error handling and validation

v2.0.0

  • Major UI overhaul with modern design
  • Enhanced shopping cart functionality
  • Improved admin dashboard
  • Advanced order management

v1.0.0

  • Initial release
  • Basic e-commerce functionality
  • Product catalog and cart
  • User authentication system

πŸš€ Future Roadmap

  • Multi-language support
  • Real-time chat support
  • Advanced AI recommendations
  • Voice ordering capabilities
  • Augmented Reality product preview
  • Integration with major smart home platforms

Thank you!


Developed by Saky

Making homes smarter, safer, and more efficient with cutting-edge IoT technology and intelligent automation solutions.

About

A comprehensive e-commerce platform specializing in smart home automation products and IoT devices.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published