Getting Started

Contents:

What does LiveArt consist of?

The LiveArt solution consits of multiple Docker images and an nginx (opens new window) for the reverse proxy setup. The following images will be run:

  1. LiveArt HTML5 Component - serves just the designer component.
  2. LiveArt Control Panel - a React-based single page application for managing LiveArt assets, pricing and orders.
  3. LiveArt Control Panel Backend - a NodeJS based application that serves the LiveArt Control Panel and the Component.
  4. Mongo (opens new window) - an underlying DB engine.

The solution is installed as Docker containers. Every Docker container has its own file system mapped to the server. Normally containers are accessed using the default SFTP user provided. Any updates to the functionality of either component are done by pushing Docker images to a certain repository, then pulling and running them on the server.

System Requirements and Limitations

End-User's Device

LiveArt is a web component that runs natively in all widely used browsers that have JavaScript enabled. The minimum browser requirements are listed below. Whichever browser you prefer, we recommend using the most up-to-date version available for the best experience.

  • Chrome (and all chrome based browsers) 40+
  • Firefox 46+
  • Safari 9.1+
  • Internet Explorer 11
  • Microsoft Edge 14+
  • Opera 27+

If LiveArt does not start for your specific browser or device, please welcome to write us (opens new window) about it mentioning versions of both device and browser you have used.

Production Output Limitations

We recommend operating LiveArt observing the below limitations. Shall you require larger production output or specific setup for your industry, please contact us (opens new window) for RFC and quote.

  • Max user image upload - 8Mb. Accepted formats are JPG, PNG, GIF, or SVG. Formats like PDF or EPS are available as an add-on.
  • Max size for default production output (PDF or PNG) - 140Mpx, printed as 40" (~1m) with 1:1 ratio at 300dpi.
  • Default output colorspace - RGB. CMYK is available as an add-on for raster output (JPEG).

Setup Requirements

  1. Server Requirements
    • Clean virtual or private Linux server;
    • SSH access (SFTP) with root access;
    • CentOS or Ubuntu (latest or LTS versions recommended);
    • Attached domain to the server;
    • Preferred vendors: Amazon, DigitalOcean;
    • Hardware requirements:
      • Minimal:
        • min 1 CPU
        • 20Gb free space
        • 1-2Gb RAM
      • Recommended:
        • min 1 CPU
        • 40Gb free space
        • 4+Gb RAM. More RAM would decrease the probability of image processing errors.
  2. Software we rely on:
  3. External services

Deployment Diagram

The diagram describes the overall LiveArt stack structure - main parts, dependencies between them, etc.

stack_birdview.jpg

Foxycart

FoxyCart store needs to be integrated with LACP (LiveArt Control Panel) to be able to place orders via Foxycart in designer.

Get new store token

  1. In FoxyCart Admin panel, go to Account > Integrations > Current integrations
  2. Click Get token, enter integration name (e.g. LACP) and save
  3. Copy access information (client_id, client_secret and refresh_token)

Setup New order webhook

In order for new FoxyCart orders to be saved to LACP database, FoxyCart must be able to send freshly created transactions to LACP.

  1. In FoxyCart Admin panel, go to Account > Integrations > Webhooks
  2. In JSON Webhooks click Add one more URL
  3. Fill data:
    1. Title - New order
    2. URL - <HTTPS URL of your LACP API>/api/ordes/confirm
      1. E.g. https://{your_domain}/liveart/lacp/api/orders/confirm for default Reverse Proxy setup;
    3. Trigger Events - ✔ Transaction Created