# ArcGIS Maps SDK for JavaScript - Map Components React

The ArcGIS Maps SDK for JavaScript provides a suite of ready-to-use UI components that simplify the process of creating GIS web applications. This package contains a [Map component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/), [Scene component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/), and many other components with functionality made possible through the SDK's [core API](https://developers.arcgis.com/javascript/latest/references/core/) which is also accessible through the components.

Want to get started immediately? See [Get started](https://developers.arcgis.com/javascript/latest/get-started/) or try out the [sample applications](https://github.com/Esri/jsapi-resources/tree/main/component-samples) for a variety of popular frameworks, module bundlers, and TypeScript.

## Deprecation Notice

> WARNING: Map Components React is deprecated in v5.0.0 and will be removed in v6.0.0.

The `@arcgis/map-components-react` package was originally developed for use with React 18 where wrappers were necessary to use custom elements. With React 19's custom element support, these wrappers are no longer needed.

Consider upgrading to React 19+ and using `@arcgis/map-components` directly. Check out the [documentation](https://developers.arcgis.com/javascript/latest/get-started/#react) to get started.

## Documentation

- [Key Features](https://developers.arcgis.com/javascript/latest/key-features/)
- [Build with React](https://developers.arcgis.com/javascript/latest/get-started/#react)
- [API and component references](https://developers.arcgis.com/javascript/latest/references/)
- [Functionality samples](https://developers.arcgis.com/javascript/latest/sample-code/)
- [TypeScript setup](https://developers.arcgis.com/javascript/latest/get-started/#typescript)

## Resources

- [ArcGIS blog](https://blogs.esri.com/esri/arcgis/tag/javascript/)
- [System Requirements](https://developers.arcgis.com/javascript/latest/system-requirements/)
- [Terms of Use](https://www.esri.com/en-us/legal/terms/product-specific-scope-of-use)
- [Licensing](https://developers.arcgis.com/javascript/latest/licensing/)
- [Working with `next` versions](https://github.com/Esri/feedback-js-api-next/blob/main/README.md)

## Support

- General questions about using this package or the ArcGIS Maps SDK for JavaScript? See the [Esri developer community](https://community.esri.com/t5/arcgis-api-for-javascript/ct-p/arcgis-api-for-javascript).
- [Technical support](https://support.esri.com/).

## Quick start guide

An [example](https://github.com/Esri/jsapi-resources/tree/50579b9362b846e869a343b660c5a2415176a275/component-samples/map-components/samples/react) is available from the 4.31 release in the jsapi-resources repo.

## License

This package is licensed under the terms described in the `LICENSE.md` file, located in the root of the package, and at https://js.arcgis.com/5.1/LICENSE.txt.
For third party notices, see https://js.arcgis.com/5.1/third-party-notices.txt.