Introduction

Overview of GroceryHub: 10 Minute Demo App | The Ultimate Multi Vendor Grocery Solution

GroceryHub: 10 Minute App is a complete Quicke Commerce & eCommerce multi-vendor grocery solution designed for seamless online shopping and efficient order management. With location-based ordering, a smart multi-cart system, and admin-controlled cart restrictions, GroceryHub: 10 Minute App ensures a smooth shopping experience. It features a flexible return system, multiple payment gateways, and diverse delivery options, including scheduled delivery, standard delivery, and self-pickup. Whether you're launching a grocery marketplace or optimizing operations, GroceryHub: 10 Minute App is your all-in-one eCommerce solution.

Thank you for choosing GroceryHub: 10 Minute App If you have any questions not covered in this documentation, please feel free to reach out to us via email(info@apksoftwaresolution.com). We’re here to assist and will respond as promptly as possible. Thank you again!

Server Requirements

All server requirements are stated bellow

  • PHP Version 8.3
  • MySQL Version 8.0+ or MariaDB version 10.6+
  • BCMath PHP Extension
  • Ctype PHP Extension
  • cURL PHP Extension
  • DOM PHP Extension
  • Fileinfo PHP Extension
  • GD PHP Extension
  • JSON PHP Extension
  • Mbstring PHP Extension
  • OpenSSL PHP Extension
  • PCRE PHP Extension
  • PDO PHP Extension
  • pdo_mysql PHP Extension
  • Tokenizer PHP Extension
  • XML PHP Extension
  • Filter PHP Extension
  • Hash PHP Extension
  • Session PHP Extension
  • Zip PHP Extension
  • allow_url_fopen()
  • file_get_contents()

Installation

Application installation process

Installation Steps:

  • Upload the groceryhub_admin_panel.zip file directly to your server after purchase to begin setup.
  • Extract the downloaded file and move all contents from thezip file to your desired installation directory. Ensure all files moved successfully.
  • Quickly set up your database using the Database Management in your control panel.
  • After creating the database, access phpMyAdmin on your server, select the newly created database, and import the project database from the groceryhub-10-min-app-v1/database folder.
    database.sql already contains everything of version 2.2, so this is the only file a new installation needs. The documentation/updation_v2.1_to_v2.2 folder is only for updating an existing v2.1 installation.
  • Set your Base URL and database credentials in the .env file in the groceryhub-10-min-app-v1/groceryhub_admin_panel folder (the folder that contains app, public and spark). If the file is not there, create a new file with exactly that name. File names that start with a dot are hidden in many file managers, so turn on Show hidden files if you can't see it.
    CI_ENVIRONMENT = production
    
    app.baseURL = 'https://yourdomain.com/'
    
    database.default.hostname = localhost
    database.default.database = your_database_name
    database.default.username = your_database_user
    database.default.password = your_database_password
    database.default.DBDriver = MySQLi
    database.default.port = 3306
    • app.baseURL is your site address. Start it with https:// and end it with /.
    • If your database password contains a space or a #, put it in single quotes.
    • Do not change app/Config/App.php or app/Config/Database.php. They only hold placeholders; the real values are read from .env.
    • Keep CI_ENVIRONMENT = production on the live server. development shows error details to visitors.
    Save it.
  • Live payments: all online payment gateways start in test mode. When you are ready to take real payments, add this line to .env and enter your live keys in Admin Panel → Payment Methods:
    payment.mode = live
  • Add one cron job that runs every hour. It sends the abandoned cart reminders and removes old activity log entries. Replace /path/to/groceryhub_admin_panel with the full path of the folder on your server (on Hostinger: hPanel → Advanced → Cron Jobs):
    0 * * * * cd /path/to/groceryhub_admin_panel && php spark store:cron >/dev/null 2>&1
  • Installation is almost complete. Your Site is now ready to browse. Simply visit http://yordomain.com (Currently website dosent show anything, necessory settiing need to update from admin panel) and admin panel is ready at http://yordomain.com/admin/auth/login log in with the credentials below
    • username:admin@gmail.com
    • password:demo1234
    your seller panel is ready at http://yordomain.com/seller/auth/login

Folder Structure

Important details about the application folder structure

  • app
  • public
  • resources
  • system
  • vendor
  • writable
  • .env
  • .htaccess
  • package.json
  • package-lock.json
  • spark
  • In the public/assets folder, you'll find all the necessary assets such as CSS, JS, and images. The two Tailwind CSS files, public/assets/admin/css/admin.css and public/assets/website/css/tailwind.css, are built from the resources folder: don't edit them by hand, see Change the Design (CSS).
  • The app folder contains the CI4 files, maintaining the full MVC structure of the project for seamless functionality and organization.
  • The writable/logs folder contains the log files. If any error occures you can find error logs here.
  • The .env file holds your Base URL, database credentials and live payment switch. Never share it: it contains your database password.
  • The system folder is the CodeIgniter framework and vendor holds the PHP libraries (PDF, payment gateways, Google). spark runs the hourly cron job.
  • The resources folder, package.json and package-lock.json are only needed to change the design on your own computer (see Change the Design (CSS)). You don't need to upload them to your server.

Change the Design (CSS)

Rebuild the CSS after changing the look of the panels or the website

The Admin Panel, Seller Panel and Website are styled with Tailwind CSS. The package already contains the built CSS files:

  • public/assets/admin/css/admin.css: Admin Panel and Seller Panel, built from resources/admin/
  • public/assets/website/css/tailwind.css: Website, built from resources/website/

Rebuild them when you add or change Tailwind classes in the views (app/Views) or page scripts, or when you edit the files in resources. A Tailwind class that the build has not seen before has no style until you rebuild.

Steps (on your own computer):

  • 1️⃣ Install Node.js: install Node.js 22 or newer from nodejs.org. Check it with:
    node -v
  • 2️⃣ Install the build tools: open a terminal in the groceryhub_admin_panel folder and run:
    npm install
    This creates the node_modules folder from package.json and package-lock.json. You only need to do it once. node_modules is not included in the package; don't upload it to your server.
  • 3️⃣ Make your changes in the views (app/Views) or in resources.
  • 4️⃣ Build the CSS:
    • Admin Panel or Seller Panel:
      npm run build:css
      This writes public/assets/admin/css/admin.css. While you are working on the panels, npm run watch:css rebuilds it every time you save a file.
    • Website:
      npm run build:website-css
      This writes public/assets/website/css/tailwind.css.
  • 5️⃣ Upload the built file to the same place on your server, together with the views you changed. Visitors get the new file right away: its link carries a version number that changes with the file.

Support

How to get assistance

Email Us: info@apksoftwaresolution.com

WhatsApp Us: +91 97668 46429

NEW RELEASE

Version 2.2 is Here! 🎉

A new update is available for GroceryHub: 10 Minute App. Already on v2.1? Follow our simple migration guide to upgrade without losing your configurations.