# Instant Apps Components

Instant Apps Components is a library of [Web Components](https://developer.mozilla.org/en-US/docs/Web/Web_Components) (Custom Elements) for use in [ArcGIS Instant Apps](https://www.esri.com/en-us/arcgis/products/arcgis-instant-apps/overview). Web Components are browser-compatible elements that use native browser APIs, are reusable, and contain encapsulated functionality. Instant Apps Components use the [Calcite Design System](https://developers.arcgis.com/calcite-design-system/), the [ArcGIS Maps SDK for JavaScript](https://developers.arcgis.com/javascript/latest/), and additional functionality that can be easily implemented into your web map applications. While this library is intended for ArcGIS Instant Apps, these components can be used in any web map application, without being tied to a particular library or framework.

## Setting up the components in your project:

### Managing assets:

In order for the components to work properly, you'll need to copy the assets to a location where they can be served by your app (for example, the public/assets directory).

For example:

`ncp node_modules/@arcgis/instant-apps-components/dist/assets public/assets`

### Importing the components:

In your entry file (index.ts), simply import the component(s) into your project.

For example:

```ts
import "@arcgis/instant-apps-components/dist/components/instant-apps-header";
import "@arcgis/instant-apps-components/dist/components/instant-apps-social-share";
```

## License

COPYRIGHT © Esri

This package is licensed under the terms described in the `LICENSE.md` file, located in the root of the package.