# @arcgis/core (ES modules)

The sample projects in this directory integrate the [@arcgis/core](https://www.npmjs.com/package/@arcgis/core) build of the ArcGIS API for JavaScript with various frameworks, module bundlers and build tools. `@arcgis/core` is installed locally using NPM.

For TypeScript users, the type definitions are included with the API. There is no need for a separate install.

For additional information, see the [Build with ES modules](https://developers.arcgis.com/javascript/latest/es-modules/) Guide topic in the SDK.

## Get Started

**Step 1** - Run `npm install` in a project directory and then start adding ArcGIS API for JavaScript functionality.

**Step 2** Configure CSS. Here's a React example:

*index.js*

```js
@import "https://js.arcgis.com/4.21/@arcgis/core/assets/esri/themes/light/main.css";
```

# @arcgis/core (ES modules)

The sample projects in this directory demonstrate using [@arcgis/core](https://www.npmjs.com/package/@arcgis/core) ES modules with various frameworks, module bundlers and build tools. `@arcgis/core` is installed using NPM, and is intended for use in local builds that you host.

### Get Started

Run `npm install` in a project directory and then start adding ArcGIS API for JavaScript functionality.

For additional information, see the [Build with ES modules](https://developers.arcgis.com/javascript/latest/es-modules/) Guide topic in the SDK.


### Bundle size

Bundle size is dependant on multiple factors and can vary depending on framework, module bundler, transpiling and related configurations. The compile process can output several hundred or more bundles on-disk due to using dynamic imports. At runtime, your application will typically only load a small portion of the bundles depending on the `@arcgis/core` functionality used. The functionality used can also affect the size of largest bundle. 

### TypeScript

For TypeScript users, the type definitions are included with the API. There is no need for a separate install.

Update ESM samples readme to include bundle size info.
Update ESM samples readme to include bundle size info.
