# prestations-ng

Best practice guide online in our DSI WiKi at [https://portail.etat-de-vaud.ch/outils/dsiwiki/x/V4EKNg](https://portail.etat-de-vaud.ch/outils/dsiwiki/x/V4EKNg)

An implementation of [Foehn](https://dsi-vd.github.io/foehn-design-system/) with Angular for [PrestaKit](https://www.vd.ch/prestakit/).

The generated documentation of our entire library is available online at [https://dsi-vd.github.io/prestations-ng/generateddoc](https://dsi-vd.github.io/prestations-ng/generateddoc)

The documentation is available online at [https://dsi-vd.github.io/prestations-ng/](https://dsi-vd.github.io/prestations-ng/)

- If you're using **Angular 19**, use `@dsivd/prestations-ng` at version `^18`.
- If you're using **Angular 17**, use `@dsivd/prestations-ng` at version `^17`.
- If you're using **Angular 15**, use `@dsivd/prestations-ng` at version `^16`.
- If you're using **Angular 13**, use `@dsivd/prestations-ng` at version `^15`.
- If you're using **Angular 12**, use `@dsivd/prestations-ng` at version `^14.5.0`.
- If you're using **Angular 11**, use `@dsivd/prestations-ng` at version `^13` until `14.4.1`.
- If you're using **Angular 9**, use `@dsivd/prestations-ng` at version `^11`.
- If you're using **Angular 8**, use `@dsivd/prestations-ng` at version `^9`.
- If you're using **Angular 6 or 7**, use `@dsivd/prestations-ng` at version `^8`.
- If you're using **Angular 5**, use `prestations-ng` at version `^7`.

Migration guides are available to provide an upgrade path from one major version to another.

- If you need to upgrade to version `18+`, please refer to [the V18 upgrade guide](UPGRADING_V18.md).
- If you need to upgrade to version `17+`, please refer to [the V17 upgrade guide](UPGRADING_V17.md).
- If you need to upgrade to version `16+`, please refer to [the V16 upgrade guide](UPGRADING_V16.md).
- If you need to upgrade to version `15+`, please refer to [the V15 upgrade guide](UPGRADING_V15.md).
- If you need to upgrade to version `14+`, please refer to [the V14 upgrade guide](UPGRADING_V14.md).
- If you need to upgrade to version `13+`, please refer to [the V13 upgrade guide](UPGRADING_V13.md).
- If you need to upgrade to version `12+`, please refer to [the V12 upgrade guide](UPGRADING_V12.md).
- If you need to upgrade to version `9+`, please refer to [the V9 upgrade guide](UPGRADING_V9.md).
- If you need to upgrade to version `8+`, please refer to [the V8 upgrade guide](UPGRADING_V8.md).

## Dependency on `prestations-be`

`@dsivd/prestations-ng` is part of [PrestaKit](https://www.vd.ch/prestakit/) and depends on `prestations-be`.

In order to use all the features of `@dsivd/prestation-ng`, you must use the same minor version of `prestations-be`, see [Notes about versioning in Prestakit](CHANGELOG.md#notes-about-versioning-in-prestakit)

`prestations-be` is available on the DSI-VD Maven repository. An exemple of integration is available with [Eldorado](https://prestations.vd.ch/pub/101016).

A bootstrap of the application (Skeleton) can be checked out at:

- Outside the DSI-VD network: `git clone https://git.vd.ch/CYBSDK/skeleton`
- Inside the DSI-VD network: `git clone ssh://bitbucket.etat-de-vaud.ch/CYBSDK/skeleton`

## Accessibility page

For accessibility testing purpose, an [accessibility page](https://dsi-vd.github.io/prestations-ng/demo-accessibilite) has been created regrouping all `@dsivd/prestations-ng` components used in Cyber prestations.

## Usage in projects

More information on how to use `@dsivd/prestations-ng` in a project are available there: [USAGE_IN_PROJECTS.md](USAGE_IN_PROJECTS.md)

## List of provided modules

A list of modules provided by the library is available there: [MODULES.md](MODULES.md).

## Contributing

If you're contributing to the project, please read first contribution guide first: [CONTRIBUTING.md](CONTRIBUTING.md).

## Changelog

Changes are listed in the [CHANGELOG.md](CHANGELOG.md).

## Examples of usage of `@dsivd/prestations-ng`

- [Espace Sécurisé](https://prestations.vd.ch/)
- [Eldorado](https://prestations.vd.ch/pub/101016)
- [e-Delai](https://prestations.vd.ch/pub/001150)
- [e-ACO](https://prestations.vd.ch/pub/001211)
- [RIE3](https://prestations.vd.ch/pub/samoa/001489)
