@zimbra/x-ui

    5.2.0 • Public • Published

    NPM Downloads NPM Version

    @zimbra/x-ui

    This repository contains the LESS variables and mixins used by zm-x-web and Zimbra X Zimlets.

    Install

    npm install @zimbra/x-ui

    Usage

    Requiring LESS variables (see variables.less):

    // Gives access to @brand-primary, @icon-size-md, etc.
    @import '~@zimbra/x-ui/refs.less';

    Requiring Mixins (see helpers.less):

    // Gives access to `fit`, `fill`, etc.
    @import '~@zimbra/x-ui/helpers.less';

    Requiring CSS Variables (recommended for Zimlets, see css-variables.less):

    // Gives access to `--brand-primary`, `--brand-secondary`, etc.
    @import '~@zimbra/x-ui/css-variables.less';

    Updating the Icon font using icomoon

    To support all platforms we require several versions of our icon font. Updating the full set of files is easily accomplished by the use of the icomoon tool.

    1. Check out the desired version of this repo.

    2. Run the icomoon app in Chrome: https://icomoon.io/app This will open to the Selection screen by default.

    3. If you have a zimbra-icons set from a previous iteration, Remove Set to start with a blank slate.

    4. Click Import Icons then navigate to your checked out repo and open selection.json. A confirmation dialog will ask:

      Your icon selection was loaded. Would you like to load all the settings stored in your selection file?

      Answer Yes, so that the existing codepoints for the icon font will be retained.

    5. From the Hamburger menu for the imported zimbra-icons set, select Import to Set then navigate to and open the new icon svg file(s) that you want to add to the set.

    6. To export as a font, first select all the glyps in the set. (Hamburger, Select all.) Click on the Generate Font tab along the bottom of the display. Review the resulting glyphs and metadata.

    7. When you're happy with what you see, click the Download action that's now on the Font tab, to download zimbra-icons.zip.

    Update the repo with the contents of the zip file by running import-icomoon.sh.

    1. Set environment variable ZM_X_UI_DIR to point to your zm-x-ui directory; the default is $HOME/github/Zimbra/zm-x-ui

      $: export ZM_X_UI_DIR="$HOME/path/to/zm-x-ui"
    2. Run script with path to zimbra-icon.zip file as argument:

      $: ./import-icomoon.sh ./path/to/zimbra-icon.zip
    3. Regenerate icon variables:

      $: npm run build
      
        or
      
      $: node generate-icon-variables

    Install

    npm i @zimbra/x-ui

    DownloadsWeekly Downloads

    233

    Version

    5.2.0

    License

    BSD-3-Clause

    Unpacked Size

    648 kB

    Total Files

    39

    Last publish

    Collaborators

    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar