Apex - Sales, Purchase and Invoicing Solution






If you have any questions that are beyond the scope of this help file, please feel free to email via my user page contact form here. Thanks so much!



Apex is built with Laravel version 5.5. This instruction assumes that you are familiar with Laravel 5.5 installation.

This project follows standard php coding style and uses webpack for asset compilation.

 

Make sure your server meets the following requirements:

 

  • Apache/Nginx
  • PHP >= 7.0.0
  • OpenSSL PHP Extension
  • PDO PHP Extension
  • Mbstring PHP Extension
  • Tokenizer PHP Extension
  • XML PHP Extension
  • Wkhtmltopdf

Wkhtmltopdf is required to generate PDF documents.

 

Download the latest wkhtmltopdf from here

 

Attention! Please note that some dependencies (libXrender for example) may not be present on your system and may require manual installation.

 

Ubuntu 16.04

 

sudo apt-get install libxrender1 fontconfig xvfb -y

wget https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.4/wkhtmltox-0.12.4_linux-generic-amd64.tar.xz -P /tmp/

cd /opt/

sudo tar xf /tmp/wkhtmltox-0.12.4_linux-generic-amd64.tar.xz

sudo ln -s /opt/wkhtmltox/bin/wkhtmltopdf /usr/local/bin/wkhtmltopdf

Follow the steps to correctly setup apex.

 

1. Upload Source Code

You should configure your web server's document / web root to be the public directory for the content from zip file.

 

2. Directory Permissions

Directories within the storage and the bootstrap/cache directories should be writable by your web server or Apex will not run.

 

We can give group ownership of our Apex directory structure to the web group by typing:

 

sudo chown -R :www-data /var/www/apex
sudo chmod -R 775 /var/www/apex/storage
sudo chmod -R 775 /var/www/apex/bootstrap/cache
 
3. Application Config
 
Next create a new database and add your database credentials to your .env file:
 
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=deployer
DB_USERNAME=deployer
DB_PASSWORD=secret
 
You will also want to update your website URL inside of the APP_URL variable inside the .env file:
            APP_URL=http://www.example.com
 
Also setup your email server config in .env to send emails.
 
MAIL_DRIVER=smtp
MAIL_HOST=smtp.mailtrap.io
MAIL_PORT=2525
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
 
You may also want to configure a few additional components of Laravel, such as: Cache, Session, Timezone, etc.
 
4. Run The Installer
 
Lastly, we can install apex by running the below.
php artisan apex:install
 
The above comand will also run php artisan key:generate --force and php artisan migrate --force
 
 
By default you should be able to login with the below email and password
 
Email: admin@apex.dev
Password: password
 
 
Please change your email and password inside user settings after login.




 

After inital login, head over to settings and fill the form to get started.

 

Note: It is important to fill the settings before sending emails.









FOR DEVELOPERS



Apex is a build with laravel 5.5 and Vue js

The app code is completely javascript writtten with Vue.js

This zip file only contain production files and does not contain node_modules directory In order to customize you have delete the vendor directory and run

composer install
npm install