Introduction

Stocky SaaS — Multi-Tenant Inventory Management System with POS, Online Store & Complete SaaS Platform.

Stocky SaaS is a powerful, multi-tenant Software-as-a-Service platform built on top of the Stocky inventory management system. It allows you to run your own SaaS business where multiple tenants (businesses) can sign up, choose a subscription plan, and get their own isolated workspace — each with a full-featured inventory system, POS, online store, and more.

The platform is divided into two main panels:

SaaS Platform Features

Tenant Features

Tech Stack

Installation

Follow this guide to install Stocky SaaS on your local machine or production server.

Server Requirements

Please ensure your server meets the following requirements before proceeding:

Installation in Localhost

1) Installation With XAMPP

2) Installation With Laragon

Nginx Configuration

If deploying to a server running Nginx, use the following configuration as a starting point. Ensure all requests are directed to public/index.php.

Installation on Server (cPanel)

Creating a New Database

Before installing, create a new empty database from your cPanel. You will need the database name, username, and password for the setup wizard.

Create Database

Database Name

Create Database User

Add User to Database

Set Full Permissions

Once the database is ready, access the URL yourdomain.com/setup to start the setup wizard.

Setup Wizard

The setup wizard guides you through three simple steps to configure your application.

Step 1 — Application Settings

Step 1 - Application Settings

Step 2 — Database Configuration

Step 2 - Database Configuration

Step 3 — Finalize Installation

Step 3 - Finalize Installation

SaaS Super Admin - Overview

The Super Admin panel is the central control hub for managing your entire Stocky SaaS platform. From here you can manage tenants, subscription plans, payments, landing page content, and all platform-wide settings.

Access the Super Admin panel by navigating to /super/login on your central domain. Only users with super_admin or admin roles can access this panel.

Super Admin Features

Permission Matrix

Super Admin accounts support two roles:

Super Admin — How It Works

This section explains how tenant provisioning works depending on your hosting mode. Stocky SaaS supports two hosting modes: VPS/Dedicated Server (fully automatic) and Shared Hosting (manual approval). You can change your hosting mode from General Settings.

Hosting Modes

VPS Mode — Automatic Provisioning

Free & Trial Plan Signup

Paid Plan Signup

Shared Hosting — Manual Approval

Free & Trial Plan Signup

Paid Plan Signup

Database Security

Tenant Status Lifecycle

Every tenant goes through a lifecycle of statuses:

Super Admin — Dashboard

The Super Admin Dashboard gives you a bird's-eye view of your entire SaaS platform. It displays key metrics and charts to help you monitor the health and growth of your business at a glance.

Key Metrics

Charts & Analytics

If you are using shared hosting mode, the dashboard will also display a list of pending tenants that require manual approval.

Super Admin Dashboard

Super Admin — Tenants Management

The Tenants section allows you to manage all tenant workspaces on your platform. Each tenant represents a separate business/organization with its own database, users, and data.

Tenant List

The tenant list displays all registered tenants with their current status. You can search and filter tenants by status.

Tenants List

Tenant Statuses

Create a New Tenant

To create a new tenant manually, click the "Create Tenant" button and fill in the following details:

Create Tenant

Tenant Actions

For each tenant, the following actions are available:

Super Admin — Plans Management

Subscription plans define what features and usage limits each tenant gets. You can create multiple plans with different pricing tiers to suit various business sizes.

Plan List

View all available plans with their pricing, status, and active subscriber count.

Plans List

Create a Plan

When creating a new plan, you can configure the following:

Create Plan

Super Admin — Subscriptions

The Subscriptions section lets you view and manage all tenant subscriptions across the platform. You can see which plan each tenant is on, their subscription status, and make changes as needed.

Subscription List

The list displays all subscriptions with the following information:

You can search subscriptions by tenant ID or company name and filter by status.

Subscriptions List

Edit a Subscription

For each subscription, you can:

Super Admin — Payments & Billing

The Payments section provides a comprehensive view of all financial transactions on your platform, including revenue tracking, payment management, and invoice generation.

Payment Dashboard

Payments Dashboard

Transaction Management

For each payment transaction, you can:

Super Admin — Admin Users

Manage all Super Admin accounts that have access to the central admin panel. You can create multiple admin accounts with different permission levels.

Creating an Admin

When creating a new admin account, configure the following:

Managing Admins

The admin list displays all accounts with their role and status. You can edit an admin's details and permissions, or delete an admin account.

Super Admin — CMS – Landing Page

The CMS module allows you to fully customize the public landing page of your SaaS platform without touching any code. Manage all sections from the admin panel with multi-language support.

Landing Page Overview

CMS - Landing Page Builder

Hero Section

The hero section is the first thing visitors see. You can customize:

Hero Section

Features Section

Showcase the key features of your platform. For each feature you can set:

Features Section

Pricing Section

Configure the headline and description for the pricing section. The pricing cards are automatically generated from your active subscription plans.

Pricing Section

Testimonials

Add customer testimonials to build trust. Each testimonial includes:

Testimonials

Additional CMS Sections

Super Admin — SEO Settings

Configure the search engine optimization settings for your landing page to improve visibility in search results.

Available Settings

SEO Settings

Super Admin — Knowledge Base

The Knowledge Base allows you to create a self-service help center for your tenants. Organize articles into categories so users can quickly find answers to common questions.

Categories

Create and manage knowledge base categories with:

Articles

Create help articles within categories:

Knowledge Base

Super Admin — Email Templates

Customize the automated email notifications sent to tenants throughout their lifecycle. All templates support multi-language translations.

Available Templates

Template Editing

For each template, you can:

Super Admin — Payment Gateway Settings

Configure the payment gateways your platform accepts for subscription payments. Multiple gateways can be enabled simultaneously, giving tenants flexibility in how they pay.

Supported Gateways

Gateway Configuration

For each gateway, you can configure:

Payment Gateway Settings

Super Admin — Mail Settings

Configure how your platform sends emails to tenants. This is required for email notifications, password resets, and subscription-related communications.

Supported Mailers

SMTP Configuration

If using SMTP, configure the following:

After configuring, use the "Send Test Email" button to verify your settings are working correctly.

Super Admin — General Settings

Configure the core platform settings that affect the entire SaaS application.

Available Settings

Cache Management

Use the "Clear Cache" button to clear the application cache. This is useful after making configuration changes or when troubleshooting issues.

POS Printer Settings

Guide to Setting Up Receipt Printer to work with POS Small Receipts

To set up receipt printer do the following:

• 1) If printer is not already installed, follow manufacturer instructions to set up the printer and install the software.
• 2) Go to settings for your printer in your operating system.

Note: The next instructions are for Windows 10 printer settings.

• Go to your Start Menu and click the Settings icon.
• Go to Devices, then Printers and Scanners. This is your printer settings.
• Once in your printer settings, find the receipt printer. Click the printer icon.
• Next click Manage, then click Printer Properties.
• Click the Advanced Tab.

• Click Printing Defaults.
• In the lower right corner of the Printing Defaults screen, click Advanced

• In Advanced Options > Advanced Document Settings, under Paper/Output the Paper Size needs to be 72mm X 200mm. If this is different change it and click OK.

• The setup of the receipt printer is complete. It should properly print small receipts.

Note: These instructions are for Windows 10. If you are using an earlier version of Windows the settings should be similar. If you are using another operating system, find your printer size, find where to set the paper size and set it to 72mm x 200mm. code>

How to use Cash drawer

• Install and run QZ Tray on each POS machine: https://qz.io/download/
• Connect the cash drawer to the receipt printer’s RJ11/RJ12 port.
• In the app: Settings → POS Receipt → enable “Open cash drawer on cash payment” and, if needed, set the Receipt printer name (as in QZ Tray / Windows).
• Complete a sale with Cash as (at least) one payment method → the drawer should open automatically after payment success.

Note: QZ Tray 2.x can require signed messages. If you see security/signing errors, you’ll need to configure certificate/signing (see QZ signing). The integration is written so that if QZ is not available or signing fails, the POS still completes the sale and only the drawer open is skipped.

🌐 Languages Management

This section allows you to manage all languages, define default ones, and control their status.

Form Fields to Add Language:

• Name: Name of the language (e.g., English, Français, العربية).
• Locale: Locale code (e.g., en, fr, ar).
• Flag: Upload the flag icon for visual identification.

Language Table Columns:

• Flag: Display the uploaded country flag.
• Name: Language name.
• Locale: Language locale key.
• Is Active: Indicates if this language is currently available in the system.
• Is Default: Marks the language as the system's default fallback.
• Actions: Edit, Delete, or Open Translations.

🈺 Translations Manager

Translate UI texts into any active language. Each key represents a word or phrase used in the system.

Translation Management Features:

• 🔍 Search Bar: Filter translation keys by value or key name.
• ➕ Add New: Insert a new translation key/value manually.
• 💾 Save: Save changes for each translation key independently.
• 📥 Save All Changes: Bulk save after editing multiple fields.
• 🔄 Reload Reminder: Prompts user to reload the page after saving to apply changes immediately.

✅ Use this interface to manage your Translations

Transfers

to create a new Transfer it's very easy

• From Warehouse (required)
• To Warehouse (required)
• Status (required)

You can manage Transfer list

• Edit Transfer
• View Details Transfer
• Delete Transfer
• Generate Transfer list in PDF
• Generate Transfer list in Excel
• Filter Transfer by Reference , To warehouse , From Warehouse , Status

Adjustments

to create a new Adjustment it's very easy

• Warehouse (required)
• Select Product (required)

You can manage Adjustment list

• Edit Adjustment
• View Details Adjustment
• Delete Adjustment
• Generate Adjustment list in PDF
• Generate Adjustment list in Excel
• Filter Adjustment by Dtae , Reference , warehouse

Accounts

to create a new Account it's very easy

• Account num (required)
• Account Name (required)
• Initial Balance (required)
• Details (optional)

You can manage Account list

• Edit Account
• Delete Account
• Generate Account list in PDF
• Generate Account list in Excel

Transfer Money

to Transfer Money between Your Accounts it's very easy

• Date (required)
• Amount (required)
• From Account (required)
• To Account (required)

You can manage Transfer Money

• Edit Transfer Money
• Delete Transfer Money

Expenses

to create a new Expense it's very easy

• Date (required)
• Warehouse (required)
• Account (Optionnal)
• Expense category (required)
• Amount (required)
• Details (optional)

You can manage Expense list

• Edit Expense
• Delete Expense
• Generate Expense list in PDF
• Generate Expense list in Excel
• Filter Expense by Date , Reference , warehouse , Expense category, Account

Deposits

to create a new Deposit it's very easy

• Date (required)
• Account (Optionnal)
• Deposit category (required)
• Amount (required)
• Details (optional)

You can manage Deposit list

• Edit Deposit
• Delete Deposit
• Generate Deposit list in PDF
• Generate Deposit list in Excel
• Filter Deposit by Date , Reference , Deposit category, Account

Quotations

to create a new quotation it's very easy

• Customer (required)
• Warehouse (required)
• Status (required)

You can manage quotation list

• Edit quotation
• View Details quotation
• Delete quotation
• Change to Sale
• Send quotation on email
• Generate quotation list in PDF
• Generate quotation list in Excel
• Filter quotation by Date, Reference , Customer , Warehouse , Status

Sales

to create a new sale it's very easy

• Customer (required)
• Warehouse (required)
• Status (required)

You can manage sale list

• Edit sale
• View Details sale
• Delete sale
• Change to Sale
• Send sale on email
• Generate sale list in PDF
• Generate sale list in Excel
• Filter sale by Date, Reference , Customer , Warehouse , Status , Payment status

Show Payment

Add Payment

Sales POS

Easy POS

• Barcode Scanner
• you can search for product by name or code
• Filter Product by Brand , Category

POS Payment

POS Invoice

Purchases

to create a new purchase it's very easy

• Supplier (required)
• Warehouse (required)
• Status (required)

You can manage purchase list

• Edit purchase
• View Details purchase
• Delete purchase
• Send purchase on email
• Generate purchase list in PDF
• Generate purchase list in Excel
• Filter purchase by Date, Reference , Supplier , Warehouse , Status , Payment status

Show Payment

Add Payment

Sale Returns

to create a new Sale Return it's very easy

You can manage Sale Return list

• Edit Sale Return
• View Details Sale Return
• Delete Sale Return
• Send Sale Return on email
• Generate Sale Return list in PDF
• Generate Sale Return list in Excel
• Filter Sale Return by Date, Reference , Customer , Warehouse , Status , Payment status

Show Payment

Add Payment

Purchase Returns

to create a new Purchase Return it's very easy

You can manage Purchase Return list

• Edit Purchase Return
• View Details Purchase Return
• Delete Purchase Return
• Send Purchase Return on email
• Generate Purchase Return list in PDF
• Generate Purchase Return list in Excel
• Filter Purchase Return by Date, Reference , Supplier , Warehouse , Status , Payment status

Show Payment

Add Payment

Customers

to create a new Customer it's very easy

• Name (required)
• Email (required)

You can manage customer list

• Pay all sell due in single payment
• Pay all sell Return due in single payment
• Edit customer
• Delete customer
• Generate customer list in PDF
• Generate customer list in Excel
• Search customer
• Filter customer by Name ,Code , phone , Email

Import Customers by csv

Suppliers

to create a new Supplier it's very easy

• Name (required)
• Email (required)

You can manage Supplier list

• Pay all Purchase due in single payment
• Pay all Purchase Return due in single payment
• Edit Supplier
• Delete Supplier
• Generate Supplier list in PDF
• Generate Supplier list in Excel
• Search Supplier
• Filter customer by Name ,Code , phone , Email

Import Suppliers by csv

Users

to create a new User it's very easy

• First Name (required)
• Last Name (required)
• Username (required)
• Phone (required)
• Email (required)
• Password (required)
• Role (required)
• Avatar (Optional)

You can manage User list

• Change Status User
• Edit User
• Generate User list in PDF
• Generate User list in Excel
• Search User
• Filter User by username , phone , Email , Status

📁 Project List

This section displays an overview of all the projects in the system, including their current status.

• ✅ Completed: Number of finished projects.
• ⏸️ Not Started: Projects created but not yet started.
• 🔄 In Progress: Projects that are currently active.
• ❌ Cancelled: Projects that have been cancelled.

Additional Features:

• 🔍 Search projects by title, customer, or company.
• 📤 Export project list to PDF or Excel.
• ➕ Click Create to add a new project.

📝 Create Project

This form allows users to register a new project with complete details.

• Title*: Enter the name of the project.
• Start Date*: Set when the project begins.
• Finish Date*: Set when the project should be completed.
• Customer*: Choose the client or project owner.
• Company*: Select the company responsible for the project.
• Assigned Employees: Assign a team to work on the project.
• Status*: Set the current status of the project.
• Details: Add any relevant notes or information.

🗂️ Task List

This section provides an overview of all tasks associated with various projects.

• ✅ Completed: Tasks that have been marked as done.
• ⏸️ Not Started: Tasks that are created but not yet started.
• 🔄 In Progress: Tasks currently being worked on.
• ❌ Cancelled: Tasks that were canceled or no longer required.

Other Features:

• 🔍 Search tasks by title, project, or company.
• 📤 Export task list to PDF or Excel format.
• ➕ Use the Create button to add a new task.

📝 Create Task

This form allows you to create a new task and assign it to a project and team.

• Title*: Task title or short description.
• Start Date*: The date work on the task should begin.
• Finish Date*: The date the task is expected to be completed.
• Project*: Select the related project this task belongs to.
• Company*: Company responsible for the task execution.
• Assigned Employees: Select which team members will perform this task.
• Status*: Choose the current state of the task (e.g. Not Started, In Progress).
• Details: Additional information or notes regarding the task.

🔁 Subscriptions List

This page allows you to view and manage all recurring subscriptions.

The table includes the following columns:

• Client: The customer subscribed to the product.
• Product: The item or service being billed.
• Warehouse: The stock location assigned for the product.
• Billing Cycle: Frequency of billing (e.g., monthly, weekly).
• Total Cycle: Number of cycles set (e.g., 12 monthly).
• Remaining Cycles: Number of invoices left to generate.
• Next Billing Date: When the next invoice is scheduled.
• Status: Active/Inactive toggle.
• Action: View, Edit, or Delete subscription.

📝 Create Subscription

This form allows you to set up a recurring product or service subscription for a customer.

• Date*: The subscription start date.
• Client*: Select the customer subscribing to the product.
• Warehouse*: Assign a stock location.
• Product*: The subscribed product or service.
• Total Cycles*: Total number of times the customer will be billed (e.g., 12 Months).
• Billing Cycle*: Choose how often the invoice is created (Monthly, Weekly, etc.).
• Price Per Cycle*: The total cost for one cycle.
• Quantity*: Number of units included per billing.
• Price Per Unit*: Individual item price, used for detailed breakdowns.
• Next Billing Date*: Date when the first (or next) invoice will be created.
• Status*: Set as Active or Inactive.

⏱️ Subscription Automation

Once a subscription is created, the system uses scheduled commands (cron jobs) to handle billing automatically.

1️⃣ Generate Invoices Automatically

php artisan subscriptions:generate-invoices

This command will automatically create a new sale (invoice) for each active subscription based on its billing cycle (daily, weekly, monthly, yearly).

2️⃣ Send SMS Reminders

php artisan subscriptions:send-sms-reminders

This command sends reminder messages to clients for upcoming or due payments via SMS.

📌 Make sure to schedule these commands in Your Cron Job in your Cpanel to run daily or as needed.

System Settings

Payment Settings

SMS Settings

POS Settings

Mail Settings

• Host : Host smtp mail server
• Port : 25 or 587 or 465 or 2525)
• Sender Name : From Name
• username : your username smtp mail server
• password : your password smtp mail server
• Encryption : tls or ssl

More Than 110 Permissions

if you want show all records of all users , Check Show all records of all users

Create new Warehouse

• Name (required)
• Phone (optional)
• Country (optional)
• City (optional)
• Email (optional)
• Zip code (optional)

You can manage Warehouse list

• Edit Warehouse
• Delete Warehouse
• Search Warehouse

You can manage Category list

• Edit Category
• Delete Category
• Search Category

Create new Category

• Name (required)
• Code (required)

You can manage Brand list

• Edit Brand
• Delete Brand
• Search Brand

Create new Brand

• Name (required)
• Description (optional)
• Image (optional)

You can manage Currency list

• Edit Currency
• Delete Currency
• Search Currency

Create new Currency

No Live Exchange Just Symbol

• Code (required)
• Name (required)
• Symbol (required)

You can manage Unit list

• Edit Unit
• Delete Unit
• Search Unit

Create new Unit

• Name (required)
• Short Name (required)
• Base Unit (optional)

Ratings & review