Full-featured invoice management application with invoicing, quotations, payments (with advance/deposit handling), expense tracking, product catalog, HR management, support tickets, SMS notifications, and multi-language support. Single-tenant architecture served under an Apache subdirectory.

• Invoice lifecycle: Draft → Sent → (Overdue) → Partially Paid → Paid
• Multi-tax engine (compound + deductible) with per-line discount support
• Client advance/prepayment management with auto-application to invoices
• Quotations with one-click conversion to invoices
• HR module: Departments, Designations, Employees, Payrolls, Tasks
• Support ticket system with replies
• SMS outbound messaging (Twilio / Vonage / Log)
• 13 languages with RTL support for Arabic
• GDPR-compliant client portal (access, rectify, erase)
• Dynamic whitelabel/branding (logos, site name, favicon)
• Activity log with notification dispatch
• Invoice PDF designer (colors, labels, logo)
• REST API (Sanctum)

• PHP 8.2 or higher (with PDO, MySQL, cURL, mbstring, XML, BCMath, JSON, Tokenizer extensions)
• MySQL / MariaDB database server
• Apache or Nginx web server
• Composer (for dependency installation)

Manual Setup

1. Upload the script files to your web server.
2. Run composer install --no-dev in the script root.
3. Set webroot to public/ directory.
4. Navigate to your domain in a browser — the installer will launch automatically.

Web Installer (Recommended)

The application includes a 5-step web-based installer that guides you through setup. Simply visit your domain and the installer starts automatically.

Step 1: Welcome

Introduction screen with the application name and a "Start Installation" button.

Step 2: Requirements Check

The installer checks PHP version (≥ 8.2) and required extensions (PDO, MySQL, cURL, mbstring, XML, BCMath, JSON, Tokenizer, Fileinfo). It also verifies directory permissions for storage/, bootstrap/cache/, and public/. Any failures are displayed with clear status indicators.

Step 3: Database Configuration

Enter your database credentials:

• Host — MySQL host (default: 127.0.0.1)
• Port — MySQL port (default: 3306)
• Database Name — The database to use (created beforehand)
• Username / Password — Database credentials
• Table Prefix — Optional prefix for all tables (default: fx_)

A connection test is performed before proceeding.

Step 4: Admin Account & Configuration

Configure the application and create the admin user:

• Application Name — Your business name
• Application URL — Auto-detected from browser URL
• Admin Name / Email / Password — Super Admin credentials

tep 5: Install

The installer executes all setup tasks with progress shown:

1. Write .env configuration file
2. Generate application encryption key
3. Run database migrations (creates all tables)
4. Seed default data (settings, roles, permissions, locations)
5. Create storage symlink
6. Create admin user account

Upon completion, you are redirected to the login page.