| Branch | Build Status |
|---|---|
| master | |
| v1.5 |
UsageRun the following command using npm:
npm install @wfp/ui
npm install @wfp/icons
or yarn:
yarn add @wfp/ui
yarn add @wfp/icons
Import a react component
import { Breadcrumb, BreadcrumbItem, BreadcrumbHome } from '@wfp/ui';
Import the CSS
import '@wfp/ui/assets/css/styles.css';
Additional information about the Usage can be found here.
View available Components here. Usage information is available when you click the blue Show Info icon in the top right corner of the selected component.
About the WFP UI GuidelinesThe 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.
PurposeThe 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.
The UI Kit is based on:
All the logo files can be found in the UI Assets repository on GitHub.
Currently the logo is available in
The Source files can be found in https://github.com/wfp/ui-assets.
All the logo files can be found in https://github.com/wfp/ui-assets.
The Sketch App and Adobe xD library can be used to easily create new User interfaces.
The downloads are available here: UI Design Kit on GitHub.
Please refer to the Contribution Guidelines before starting any work.
Use the feat/ branches for active development.
We recommend the use of React Storybook for developing components.
npm run test
npm run storybook
http://localhost:9000/./components folder. Add the export to index.js to include them into the build./.components with .stories.js or stories.mdx ending.Use Conventional Commits for commit messages and pre-commit hooks for commiting.
Make sure your commit does not produce any errors while checking:
Use jest for testing the components. Once commited the branches will be also tested on Travis CI.
npm run test
The UI Kit uses Azure Devops and semantic-release for automate versioning and CHANGELOG generation.
master branch will be released as @lastest if a relevant commit is included (e.g. feat, fix, perf, breaking)next branch will be released as @next if a relevant commit is includednpm run release -- --prerelease alpha
npm publish --tag alpha
or
git push --follow-tags origin next && npm publish --tag alpha
npm run release
npm publish
Create a new build for the documentation and copy the assets and docs folder manually to WFP`s AWS S3 instance following the naming scheme (for example: v1.2.1).
npm run build:storybook
Edit the website-redirect-location meta tag of index.html to point wfp.org/UIGuide to the latest documentation folder. This can be done with MountainDuck.
Edit the first line of assets/depreciation-warning.html to point to the latest version of the UI Kit.
Clear the Server cache with Cloudfront Purge Tool.
FAQs
WFP UI Kit
The npm package @wfp/ui receives a total of 322 weekly downloads. As such, @wfp/ui popularity was classified as not popular.
We found that @wfp/ui demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 8 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
GitHub removed 27 malicious pull requests attempting to inject harmful code across multiple open source repositories, in another round of low-effort attacks.
Security News
RubyGems.org has added a new "maintainer" role that allows for publishing new versions of gems. This new permission type is aimed at improving security for gem owners and the service overall.
Security News
Node.js will be enforcing stricter semver-major PR policies a month before major releases to enhance stability and ensure reliable release candidates.