Skip to content

BuildWithHussain/ls_shop

Repository files navigation

LS Shop

A modern, multilingual e-commerce solution built on Frappe Framework that extends ERPNext's capabilities with custom frontend and advanced product management.

Screenshot 2025-09-10 at 1 47 38 AM

RTL

Screenshot 2025-09-10 at 1 49 46 AM

🌟 Features

🌍 Multilingual Support

  • Built-in internationalization with URL-based language switching (/en/, /ar/)
  • Seamless translation management using Frappe's native translation system
  • RTL (Right-to-Left) language support

🛍️ Advanced Product Management

  • Style Attribute Configurator (SAC): Manage item templates with attributes
  • Style Attribute Variants (SAV): Handle product variations efficiently
  • Support for complex product hierarchies with multiple attributes and sizes
  • Bulk operations for product creation and management

⚡ Performance Optimized

  • Server-side rendering with Jinja templates
  • 6x faster loading times compared to traditional SPA approaches
  • Optimized for Core Web Vitals and SEO

🎨 Modern Frontend

  • Built with Tailwind CSS for responsive design
  • Alpine.js for reactive components
  • Component library integration (Pines UI, Penguin UI)
  • Clean, professional design system

💼 E-commerce Capabilities

  • Integration with ERPNext's accounting and inventory
  • POS integration for offline stores
  • Payment gateway integrations (including BNPL services like Tabby)
  • Partial refunds and returns management
  • Consolidated stock management across channels

📄 Pages & Features

The application includes the following key pages and functionalities:

Frontend Pages

  • Homepage: Modern landing page with product highlights
  • Product Catalog: Advanced filtering and search capabilities
  • Product Details: Comprehensive product information with variants
  • Shopping Cart: Seamless cart management
  • Checkout: Streamlined checkout process
  • User Account: Order history and profile management
  • Multi-store Support: Support for multiple physical locations

Admin/Backend Features

  • Admin Dashboard: Bulk operations and reporting tools
  • SAC Management: Style Attribute Configurator administration
  • SAV Management: Style Attribute Variants handling
  • Bulk Operations: Mass product creation and image uploads
  • Reporting: Consolidated inventory and sales reports

🚀 Quick Start

Prerequisites

  • Frappe Framework (v13+)
  • ERPNext
  • Node.js and npm (for asset compilation)

Installation

  1. Clone the repository:
git clone https://github.com/yourusername/ls_shop.git
cd ls_shop
  1. Install the app:
bench get-app https://github.com/BuildWithHussain/ls_shop
bench install-app ls_shop --site your-site-name
  1. Build assets:
bench build --app ls_shop

Key Components

  • WWW Directory: Server-rendered pages for optimal performance
  • Custom Doctypes: SAC and SAV for advanced product management
  • Hooks Integration: URL routing and custom business logic
  • API Layer: RESTful APIs for frontend interactions

Project Structure

ls_shop/
├── ls_shop/
│   ├── hooks.py              # App configuration and hooks
│   ├── www/                  # Public web pages
│   ├── templates/            # Jinja2 templates
│   ├── public/               # Static assets
│   └── ls_shop/              # App modules
├── requirements.txt          # Python dependencies
└── package.json             # Node.js dependencies

📊 Bulk Operations

LS Shop provides powerful bulk operation capabilities:

  • Bulk SAC/SAV Creation: Create multiple product configurations at once
  • Bulk Image Upload: Upload and associate product images in batches
  • Bulk Publishing: Publish multiple products to the website simultaneously
  • Consolidated Reporting: Generate comprehensive reports across all items

🔧 Configuration

Language Setup

Configure supported languages in hooks.py:

website_route_rules = [
    {"from_route": "/", "to_route": "/en"},
    {"from_route": "/<path:app_path>", "to_route": "/en/<path:app_path>"},
]

Payment Gateway Integration

The app supports various payment gateways. For Tabby BNPL integration, check out our companion app: tabby_frappe

🏢 About BWH Studios

LS Shop is developed and maintained by BWH Studios, a tech company based in Jagdalpur, Chhattisgarh, specializing in Frappe customizations and consulting.


⭐ If you find LS Shop helpful, please consider starring the repository!

About

Lifestyle Ecommerce extension for ERPNext

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published