View the samples at https://vertigis-web-samples.netlify.app.
This project includes a collection of samples that demonstrates how to configure and customize VertiGIS Studio Web apps using the VertiGIS Studio Web SDK. Before diving into the SDK, be sure to check out our Developer Center to learn the various concepts of building and configuring VertiGIS Studio Web applications. There is a surprising amount that can be accomplished through layout, app config, and VertiGIS Workflow which can be configured in the app config without even needing to use the SDK!
Check out the hosted samples viewer for an easy way to run the samples in your browser without needing to run the project locally. The source for each sample is located within the samples directory of this project.
You will need to install the latest LTS version of Node.js.
You can install the dependencies for all sample projects by running yarn
at the root of this repository. The easiest way to install and update yarn is to run npm install -g yarn
.
Alternatively you may install the dependencies for a single sample project by running yarn
or npm install
in the root of a sample directory.
Run yarn start
or npm start
within the root of a sample directory. For example you can run the i18n
sample by running yarn start
within the samples/i18n directory. This will launch the VertiGIS Studio Web SDK development server.
Each sample follows the same pattern as the VertiGIS Studio Web SDK. The easiest way to create a new sample is to copy an existing sample directory, and rename the name
property in the package.json
of your sample to suit. Once created you will need to add your sample to the samples viewer libraries
config in samples/library-viewer/app/app.json to have it show up in the list of samples.
The tests for each sample are located in the cypress/integration directory.
The samples will need to be built prior to running the test using yarn build:samples
. You can run the tests in interactive watch mode using yarn test:watch
, this will allow you to run individual tests, or use yarn test
from the root of this project to run all of the tests .
To run the samples viewer, first build all of the sample projects by running yarn build:samples
in the root of this project, followed by running yarn start
to start the viewer.
You can learn more on the VertiGIS Studio Developer Center.