Design guidelines

The Freshdesk UI is built on a modified version of the Bootstrap v3.3 framework. The user interface of apps that are to be published on Freshworks Marketplace need to be consistent with the Freshdesk UI. We do not enforce this for custom apps but it is highly recommended for better user experience. This section provides information on the default Freshdesk UI stylesheet and how to include a custom stylesheet.

Example UI of a CRM app.

Here are a few guidelines that you need to follow.

  1. Import the Freshdesk app stylesheet in all templates and ensure that the class names of UI elements used in the app match those used by Bootstrap.

    template.html

    <link rel="stylesheet" type="text/css" href="https://static.freshdev.io/fdk/2.0/assets/freshdesk.css">

  2. All template files should contain a div block with class="fw-widget-wrapper" inside the body of the template. This is used to implement styles which are applicable to all elements of the app.

    1<body>
2<div class="fw-widget-wrapper">
3//template code
4</div>
5</body>

  3. A few elements and their usage are listed in the following table.

ELEMENTUSAGE
Label - Defines a label for an input element
<span class="label">Company</span>
Section Divider - Separates various sections of the app.
<div class="fw-divider"></div>
Links - Allows users to move from one page to another.
No class needs to be added.
<a href="">First Opportunity</a>
List - All divs within the parent are placed one after the other.
If you are using this template to display field names and values, use the muted class for field names.
<div class="fw-content-list">
  <div class="muted">Email</div>
  <div>tom@outerspace.com</div>
</div>