Description

Design Factory Angular is the package containing the Angular components implementing the Amadeus Design System, Design Factory.

Design Factory is an InnerSource design system made of:

• A UI library for Amadeus external and internal interfaces and applications, based on our four pillars
• A set of design and coding best practices
• A cross-functional community from all Amadeus business units

If you want to get more information about Design Factory, please contact Design Factory team.

Getting started

You can easily add Design Factory library in your project thanks our schematics. Just run the following:

ng add @design-factory/angular

It will install Design Factory for the default application specified in your angular.json. If you have multiple projects and you want to target a specific application, you could specify the --project option

ng add @design-factory/angular --project myProject

Architecture

The Design Factory is composed of multiple projects and you can install the package that fits your requirements.

• @design-factory/tokens includes the Design Tokens that empower the Design System
• @design-factory/styles includes the styles, composed of utilities and component styles
• @design-factory/design-factory contains Angular components and utilities. They will be migrated to the following package
• @design-factory/angular contains the new SideNav and will grow to include all Design Factory Angular components

CSS namespace feature

For some specific cases, you may have to use the CSS namespace feature which allows you to apply DF styles only under a selector defined by $df-css-namespace-selector variable (by default ==.design-factory-v2==). In order to use this feature, just import the following:

@import '@design-factory/styles/scss/namespace';

in your styles.scss and add the defined selector in your HTML element where you want to apply DF style.

Dependencies

The dependencies are Angular, Bootstrap 5, Ng-bootstrap, AgnosUI, Ng-select, Ag-grid and ngx-slider. The supported versions are:

| Design Factory | Angular | Bootstrap CSS | Ng-Bootstrap | Ng-select | Ag-grid | AgnosUI | | -------------- | ------- | ------------- | ------------ | --------- | ------- | ------- | | 21.0.x | 21.x | 5.3.8 | 20.0.x | 21.x | 35.x | 0.10.x |

How to work with the icons

Icons are a mix of Font Awesome (FW) and in-house produced pictograms.

Since DF 18.0.0 release in-house icons and FW icons are split into different fonts.