> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-en/sdks/sdk-web/introduccion/instalacion.md).

# Installation

Installing the Facephi SDK Web component.

The SDK Web is a component library *custom elements* compatible with any modern framework.

There are two versions of the SDK Web library:

* **SDK Web WebComponents**: A web-components library, compatible with most frameworks and environments.
* **SDK Web React**: A version with native React components. This library includes all the features of the WebComponents version, but uses syntax suited to React.

***

## Download credentials

Create a file named `.npmrc` in your project root with the following contents:

```bash
@facephi:registry=https://facephicorp.jfrog.io/artifactory/api/npm/sdk-web-fphi/
//facephicorp.jfrog.io/artifactory/api/npm/sdk-web-fphi/:_password=[TU_TOKEN]
//facephicorp.jfrog.io/artifactory/api/npm/sdk-web-fphi/:username=[TU_USUARIO]
//facephicorp.jfrog.io/artifactory/api/npm/sdk-web-fphi/:email=[TU_EMAIL]
//facephicorp.jfrog.io/artifactory/api/npm/sdk-web-fphi/:always-auth=true
```

Replace `[TU_TOKEN]`, `[TU_USUARIO]` and `[TU_EMAIL]` with the provided credentials.

***

## Library installation

There are two main ways to integrate the Facephi SDK Web into your application: using a package manager or a CDN. Both options offer the same features.

### Installation using a package manager

Recommended for projects that use modern frameworks such as React, Angular, or Vue.

The SDK Web package is hosted in a private NPM repository. Follow these steps to install it:

#### SDK Web Components

Run the following command in your project terminal:

```bash
npm install @facephi/sdk-web-wc
```

Versions are also available for **React** and **Angular** with native versions for those environments. See the [framework integration](https://docs.facephi.com/docs.facephi-en/sdks/sdk-web/frameworks-y-samples.md#wrappers-espec-c3-adficos-de-framework) section for more information.

Make sure the installation completes without errors before continuing.

***

### Installation from a CDN

For projects that don't use a package manager, you can integrate the SDK using a CDN link:

```javascript
import 'https://cdn.facephi.pro/@facephi/sdk-web-wc@latest/bundle?bundle=false';
import { defineCustomElements as defineCustomFacephiSDKElements } from 'https://cdn.facephi.pro/@facephi/sdk-web-wc@latest/bundle?bundle=false';

defineCustomFacephiSDKElements(window);
```

This loads the latest version of the SDK directly from Facephi's servers.

The rest of the integration is the same in both cases.

***

## Next steps

* Continue to [Initial configuration](https://docs.facephi.com/docs.facephi-en/sdks/sdk-web/introduccion/primeros-pasos.md).
* Review the [Integration examples](https://docs.facephi.com/docs.facephi-en/sdks/sdk-web/ejemplos-de-integracion.md).
