Amadeus Design Factory Angular implementation
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/tokensincludes the Design Tokens that empower the Design System@design-factory/stylesincludes the styles, composed of utilities and component styles@design-factory/design-factorycontains Angular components and utilities. They will be migrated to the following package@design-factory/angularcontains 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 |
| 22.0.x | 22.x | 5.3.8 | 21.0.x | 23.x | 35.x | 0.11.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.