solutions-components are shared web components used in Solutions apps.
Supported browsers are the latest versions of Google Chrome, Apple Safari, Mozilla Firefox, and Microsoft Edge (Chromium).
The repository is set up to use Volta for standardizing the versions of NodeJS and npm. Please install and use this app to get the supported versions.
The repository uses StencilJS to manage web component development; the project is a
web_component project type.
To interactively transpile components and update the display of src/index.html via http://localhost:3333/src:
Note this feature excessively caches; sometimes you have to rebuild manually and force a refresh.
One can also run index.html in the top-level directory, which is the same as src/index.html but for the path to the
To add a component, run
npm run generate
with the new component's name as an argument (or specify the name when prompted).
To build the component for debugging, run:
npm run build:debug
To build the component for production, run:
npm run build
To run the unit tests for the components, stop automatic compilation (e.g., Visual Studio) and run:
npm run clean:src npm test
To publish to npm and GitHub,
- Edit package.json to have the new version number
- Edit CHANGELOG.md to show the new release number and connect it to previous releases
- Commit and push changes to GitHub
Find a bug or want to request a new feature? Please let us know by submitting an issue.
Copyright 2021 Esri
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
A copy of the license is available in the repository's LICENSE file.