Visit on CodeCanyon

E-Cartify - Modern Point of Sale and Stock Management v1.1

by Jejookit

Getting Started

Thank you for purchasing our script. If you have any questions that are beyond the scope of this help file, please feel free to contact us via our jejookit@gmail.com. Thank you very much!

Introduction

E-Cartify is a comprehensive POS system crafted with Laravel and Flutter Framework. Laravel, a PHP Framework, boasts an expressive, elegant syntax, allowing you to focus on creation rather than trivial details. Meanwhile, Flutter, developed by Google, is an open-source framework for mobile app development, catering to Android and iOS platforms. E-Cartify consists of Mobile Applications & Web Panel The mobile applications for Android & iOS are built using Flutter, while the web panel is developed using Laravel.

Technologies used:
  • PHP Laravel
  • Flutter
  • Dart
  • API
  • HTML 5
  • CSS 3
  • Bootstrap
  • JQUERY
  • AJAX
Key Features:
  • Clean and Responsive Design
  • Built Using Bootstrap
  • Totally Secure System
  • RTL Support
  • All features related to POS, including POS invoicing.
  • Product management with barcode functionality
  • Order and transaction history tracking
  • Accounts or financial management for your business
  • Stock-out alerts
  • Customer management
  • Supplier management
  • Coupon management
  • Multi-language support within the application.
  • Multi-currency support within the application.

Security:
E-Cartify is a secure system. There are various mechanisms to secure application. These mechanisms are:
  • Cross-Site Request Forgery (CSRF) Prevention
  • Cross-Site Scripting (XSS) Prevention
  • Password Hashing
  • Avoiding SQL Injection

Requirements:
Web App
There are some requirements for E-Cartify to work on your server. These requirements are:
  • PHP >= 8.1
  • Mysql >= 5.7
  • Mod_rewrite Apache
  • cURL PHP Extension
  • Fileinfo PHP Extension
  • Exif PHP Extension
  • Mbstring PHP Extension
  • Ctype PHP, JSON, Mbstring, OpenSSL, PDO, Tokenizer, XML, Zip, Fileinfo, Gd, sodium Extension
Mobile App
  • Android studio
  • Flutter SDK setup (version 3.19.X Stable)
  • JDK with path setup (only for vs code)
  • Xcode for IPA file build

Installation

License Code
You need a license code to install the script. You can download this license code from Codecanyon. To download the license code, follow these steps:
  • Go to Codecanyon and login to your account.
  • Go to your account and click "Downloads" section.
  • Find the script and click "Download" button.
  • Click "License certificate & purchase code" link and download the license code.

If you cannot find the license code, here is a direct link to download the license code: Where Is My Purchase Code?

You can follow these steps to install the web app:

1. Create a new Database with user that has all permissions.
  • Go to cPanel and Click MySQL® Databases



  • Create New Database



  • Add New User



  • Add User To Database



  • Set User Permissions


2. Upload script files to your hosting (FTP).

  1. Open your cPanel and go to File Manager section.

  2. Go to main directory of your site. Most of the time this folder will be "public_html".



  3. Open this folder and upload codecanyon-.zip file to this folder.

  4. Rigth click the .zip file and select Extract option.

  5. Move all files that in the "ecartify-v.." folder to main directory.

3. You will see this page after uploading all files to your FTP. If you cannot see this page, you can access install page by entering this link to your browser address bar: http://yourdomain.com/install



4. Enter your license code and then click Next.

5. You will see this page after entering your license code. Click Get Started.

6. Check system requirements. If one of these extensions is not enabled, you must enable it from your server settings. If all requirements are provided, click Next.



7. Enter your database credentials. Click next.



8. Click import button to import the database.





Fill for the admin user information and click Next.



9. You will see this page after installation. Click Go to Admin Panel.





10. After the installation, if you see "page login".





You can follow these steps to install the Flutter app:



You have to download and setup flutter from flutter.dev. You can follow documentation with your own device.

1. Open the project in your IDE (Android Studio or VS Code).



2. Open the terminal and run the following command:



flutter pub get

3. If you want to change the API URL, you can change it in the lib/util/app_constant.dart file.



static const String baseUrl = 'change_your_api_url_here';

4. Run the project in your emulator or physical device.



5. If you want to build the APK file, run the following command:



flutter build apk

6. If you want to build the IPA file, run the following command:



flutter build ios

7. If you want to change the color, you can change it in the lib/util/color_resources.dart file.



8. If you want to change the app icon, you can change it in the android/app/src/main/res/mipmap folder. You can generate your app icon from https://icon.kitchen website.





9. If you want to change the app name, you can change it in the android/app/src/main/AndroidManifest.xml file.



10. If you want to change the app package name, you can change it in the android/app/src/main/AndroidManifest.xml file.



Local server (not mandatory)

File Upload Settings

If you want to upload large files, you may need to make some settings on your server. Also, E-Cartify performs image optimization while uploading images. This optimization uses memory.

If you try to upload large files without doing some settings on your server, you can get an error.

If you can't upload large files, you need to set these PHP values. These are recommended minimum values.

php_value upload_max_filesize 32M
php_value post_max_size 32M
php_value memory_limit 256M

To set these values follow the steps:

  1. Go to your cPanel and click "Select PHP Version"



  2. Then click "Switch to PHP Options"



  3. Then set the values "upload_max_filesize", "post_max_size" and "memory_limit" as you see in the picture.



Customization

✓  Add New Local Language
  • Go to /assets/language and press right button on language folder and create new file and name it with your language code (.json). For example if your language is Bengali then you have to named your file as bn.json. You have to name it with proper and valid language code otherwise app won’t work. For getting language and country code you can visit this url: https://docs.oracle.com/cd/E13214_01/wli/docs92/xref/xqisocodes.html
  • Copy all data from en.json and paste it in your created file.
  • Translate all English text placed here after colon(:) to your local language. There texts are in key-value formatted. You have to translate value only not key otherwise it won’t work. For example: “home”: “Home” -> “home”: “বাড়ি”
  • Add your country picture on /assets/image folder.
  • Open /lib/util/app_constrants.dart, scroll down to bottom and add one more LanguageModel under languages array with your imageUrl, languageName, countryCode and languageCode. Again must remember that your language code and country code should valid otherwise app won’t work. In image url field you have to put your image path as assets/image/added_country_picture_name.extension. For example if your added country picture name is italian.png then path will be assets/image/italian.png.

✓  Change App Color
  • Open /lib/theme/light_theme.dart file and set primary, accent and etc. colours for light theme.
  • In the same way open /lib/theme/dark_theme.dart file and set preferred primary, accent and etc. color for dark theme.

✓  Change App Font
  • Download you preferred font from internet. Google has many free font you can check them: https://fonts.google.com
  • Unzip fonts and paste it them to /assets/font/ folder.
  • Mentioned them in /pubspec.yaml file like: fonts:
    • family: YOUR_FONT_FAMILY_NAME fonts:
        asset: assets/font/YOUR_FONT_FILE_NAME.ttf weight: YOUR_FONT_WEIGHT
  • Replace font family name in /lib/theme/light_theme.dart, /lib/theme/dark_theme.dart and /lib/util/styles.dart file.

App build & release

Build for Android

For debug build you can run command:

flutter build apk

You will get a larger merged apk with this. But you can split them with this command:

flutter build apk --target-platform android-arm,android-arm64,android-x64 --split-per-abi

Build file location: /build/app/outputs/flutter-apk/ For deploying it please follow this documentation:



Build for iOS

For debug build you can run command:

flutter build ios

For release build you can run command:

flutter build ios --release

Build file location: /build/ios/ For deploying it please follow this documentation:

Update Guide

Admin Panel


- Download the latest version of the script from Codecanyon.
- Extract the downloaded file.
- Upload all files to your server using FTP. Make sure you replace all files except the storage folder.
- If you have customized the script, you should be careful while replacing the files. You can lose your customization.
- After uploading all files, go to your admin panel and check if the version is updated.
- If you see the updated version, you have successfully updated the script.
- If you see any error, please contact us.

Mobile App


- Download the latest version of the script from Codecanyon.
- Extract the downloaded file.
- Open the project in your IDE (Android Studio or VS Code).
- Open the terminal and run the following command:
flutter pub get
- Run the project in your emulator or physical device.
- If you want to build the APK file, run the following command:
flutter build apk
- If you want to build the IPA file, run the following command:
flutter build ios
Update after Customisation

If you customized something on the code and want to update to our latest version follow any option given below: