1. Item Name : Inventual – Complete POS, Inventory Website and Mobile Flutter App
  2. Created: 20 August, 2024
  3. Item Version : v1.0.0
  4. Author : Bdevs
  5. Support Ticket: https://support.bdevs.net/

Welcome to Documentation

Inventual is a complete POS, Inventory website and Mobile Flutter App. Here is included two projects. One is complete solution a pos website application using Laravel 10 & React build with Inertia and another is mobile flutter app with APIs of Laravel 10 backend. Also It has included swagger API documentation. So you can understand easily how many APIs are there and how it works. Click on APIs documentation to view

We will describe how to install both Linux server and cpanel server and included the instructions of minimum php version, creating database and managing files on a server.

We are available in our support desk if you're not familiar with the procedures presented. Click on Support Desk

License

Regular License

Use, by you or one client, in a single end product which end users are not charged for. The total price includes the item price and a buyer fee.

Extended License

Use, by you or one client, in a single end product which end users can be charged for. The total price includes the item price and a buyer fee.

Please purchase Extended License if you are going to sell as a service. Envato License Policy

Server Requirements

It is laravel 10, it's minimum server requirements or alternatively you can contact with your hosting provider.

  • PHP >= 8.1
  • Mbstring PHP Extension
  • PDO PHP Extension
  • BCMath PHP Extension
  • XML PHP Extension
  • Ctype PHP Extension
  • Fileinfo PHP extension
  • JSON PHP Extension
  • OpenSSL PHP Extension
  • Tokenizer PHP Extension

Ubuntu / Linux / Localhost Installation

Go to root of project folder and follow the below step.

Step 1: Open your terminal/gitbash and run - composer install

Step 2: run - php artisan migrate

Step 3: run - php artisan db:seed

Step 4: run - php artisan serve

If you want to run project with valet. You do not need to run step 4. You have to open terminal with project and run the below commands.

Step 4: run - valet link inventual(project-name)

Step 5: for secure url run - valet secure inventual(project-name)

Now you are alomst complete your step, here you just need to clear cache with below commands.

Step 6: run - php artisan cache:clear

Step 7: run - php artisan route:clear

Step 8: run - php artisan config:clear

Step 9: run - valet link inventual

Step 10: run - valet link inventual

If you will change code, so you have to regenarate swagger api again. Don't worry you can do it with the below command.

Step 11: run - php artisan l5-swagger:generate

We are now in final stage. We need to compile sass & node packages with the below command.

Step 12: run - npm install and npm run dev

Step 13( production ): run - npm install and npm run build

Step 14: run - php artisan key:generate

 ...

eaxmple: .htaccess at root path


	
		
			Options -MultiViews -Indexes
		
	
		RewriteEngine On
		RewriteRule ^(.*) public/$1 [L]
	
	

Environment Configuration (.env)


	IS_SECURE_URL=false
	APP_URL=https://inventual.test
	APP_IMAGE_URL=https://inventual.test/storage/
	ASSET_URL=https://inventual.test
	.
	. 
	DB_DATABASE=laravel_inventual
	DB_USERNAME=root
	DB_PASSWORD=

Vite Configuration (vite.config.js)


	const host = 'localhost';

	export default defineConfig({
		server: {
			https: true,
			hmr: { host },
		},
		plugins: [
			mkcert(),
			laravel({
				input: [
					'resources/sass/app.scss',
					'resources/js/app.jsx',
				],
				refresh: true,
			}),
			react(),
		],
	});

CPanel Installation

We have described it step by steps in below:

Create New Database

You need to create new database from cpanel before starting installation. You can follow the below steps:

image
Step 1: Create a new user
image
Step 2: Add the user to the database
image
Step 3: Select full permissions on the database to that user
image

Upload File to Server

Upload inventual folder on the web root folder of your domain.

Go to root of project folder and follow the below step.

Step 1: Open terminal from server

Step 2: run - php artisan migrate

Step 3: run - php artisan db:seed

Step 4: run - php artisan l5-swagger:generate

We are now in final stage. We need to compile sass & node packages with the below command.

Step 5: run - npm install and npm run build

Step 14: run - php artisan key:generate

Dashboard Login

Wow, You have done all procedures of installation. Login your dashboard with below credentials.

Upgrade

Faq

You are available in our Support Desk.

Yes, It will need for developing your site with MAC OS config can be like this. See code from View

It is for Linux server. See code from View

You have to do it for running project cpanel smoothly and avoiding public folder as root.

If you can not login in your backend, you have to add SESSION_DOMAIN & SANCTUM_STATEFUL_DOMAINS in .env file.

SESSION_DOMAIN=Your_backend_url

SANCTUM_STATEFUL_DOMAINS=Your_backend_url

Please check .env.example file in root of project root.