@wfp/ui

World Food Programme UI Kit (WFP-UI)

Branch	Build Status
master
next

Usage

Installation

Run the following command using npm:

npm install @wfp/ui -develop

or yarn:

yarn add @wfp/ui -D

Import a react component

import { Breadcrumb, BreadcrumbItem, BreadcrumbHome } from '@wfp/ui';

Import the CSS

@import '@wfp/ui/css/styles';

Additional information about the Usage can be found here.

Documentation & list of components available

View available Components here. Usage information is available when you click the blue ? icon in the top right corner of the selected component.

About the WFP UI Guidelines

The new WFP UI Kit is based on the World Food Programme’s Branding Guidance WFP's new branding was launched in early 2018 and will be implemented across the organization, strengthening WFP’s brand image through consistent representation.

Building on this initiative, the World Food Programme’s User Interface Style Guide emphasizes WFP’s commitment to establish and build the brand.

Purpose

The purpose of this project is to create a unified toolkit that is used by UX-designers and developers alike on their projects to ensure all WFP-branded projects are accessible, appealing, and have a consistent look and feel across the board by following WFP’s design and implementation guidelines.

The guidelines contained in this guide are to be applied to all WFP digital products (such as: websites, web applications, internal systems and other).

By unifiying design elements into reusable components, development will simplify and accelerate the development of these digital products.

The Guide is a living document created to meet the needs of WFP’s front-end developers and designers. If there is a Component or Pattern that you need, or you have any other feedback, question or comment please contact us.

Credits

The UI Kit is be based on:

• Carbon Components
• U.S. Webdesign System
• Sketch Favicon Exporter Template

Logos

All the logo files can be found in the wfp-ui/logos folder. Currently the logo is available in

• Colors: blue, white and black
• Fileformat: svg, png in different sizes
• Languages: arabic, english, spanish, french

The Source files can be found in sketch/WFP Logos.sketch.

Sketch Library

The Sketch Library can be used to easily create new UI in Sketch App. You can download it Sketch App.

Favicons

All the logo files can be found in the wfp-ui/favicons folder. The full sizes catalog which has to be added to the header.

<link rel="apple-touch-icon" sizes="57x57" href="/favicons/apple-icon-57x57.png">
<link rel="apple-touch-icon" sizes="60x60" href="/favicons/apple-icon-60x60.png">
<link rel="apple-touch-icon" sizes="72x72" href="/favicons/apple-icon-72x72.png">
<link rel="apple-touch-icon" sizes="76x76" href="/favicons/apple-icon-76x76.png">
<link rel="apple-touch-icon" sizes="114x114" href="/favicons/apple-icon-114x114.png">
<link rel="apple-touch-icon" sizes="120x120" href="/favicons/apple-icon-120x120.png">
<link rel="apple-touch-icon" sizes="144x144" href="/favicons/apple-icon-144x144.png">
<link rel="apple-touch-icon" sizes="152x152" href="/favicons/apple-icon-152x152.png">
<link rel="apple-touch-icon" sizes="180x180" href="/favicons/apple-icon-180x180.png">
<link rel="icon" type="image/png" sizes="192x192"  href="/favicons/android-icon-192x192.png">
<link rel="icon" type="image/png" sizes="32x32" href="/favicons/favicon-32x32.png">
<link rel="icon" type="image/png" sizes="96x96" href="/favicons/favicon-96x96.png">
<link rel="icon" type="image/png" sizes="16x16" href="/favicons/favicon-16x16.png">
<meta name="msapplication-TileColor" content="#006CB6">
<meta name="msapplication-TileImage" content="/ms-icon-144x144.png">
<meta name="theme-color" content="#006CB6">

Development

Please refer to the Contribution Guidelines before starting any work.

Using the server

We recommend the use of React Storybook for developing components.

1. Start the server:

   $ yarn storybook
   

2. Open browser to http://localhost:9000/.

3. Develop components in their respective folders (/components or /internal).

4. Write stories for your components in /.storybook.