Skip to content

Create your own MapStore project


From version 2021.02.xx MapStore introduced a new project system. Take a look here to learn more about the new project system.

To create a new MapStore based project you can use the createProject script. First of all, if you don't have done it before, clone the MapStore2 repository master branch into a local folder:

git clone

Then, move into the folder that has just been created, containing MapStore2:

cd MapStore2

Install dependencies for MapStore:

npm install

Finally, to create the project, use the following command:

node ./createProject.js <projectType> <projectName> <projectVersion> <projectDescription> <gitRepositoryUrl> <outputFolder>

Note that projectName and outputFolder are mandatory:

  • projectName: short project name that will be used as the repository name on github, webapp path and name in package.json
  • projectType: type of project to create, currently two types of projects are supported:
  • standard: is a copy of the standard MapStore project, ready to be used and customized
  • custom: is a simple (skeleton) project, useful if you want to build a custom application using the SDK
  • projectVersion: project version in package.json (X.Y.Z)
  • projectDescription: project description, used in sample index page and as description in package.json
  • gitRepositoryUrl: full url to the github repository where the project will be published
  • outputFolder: folder where the project will be created

At the end of the script execution, the given outputFolder will be populated by all the configuration files needed to start working on the project. Moreover, the local git repository will be initialized and the MapStore sub-module added and downloaded.

If you create a standard project, you can customize it editing js/app.jsx: look at the comments for hints and the MapStore documentation for more details.

If you create a custom project, you will find a simple application in the js folder (app.jsx is the entry point) with two pages (home and main).

The following steps are:

  • npm install to download dependencies
  • npm start to test the project
  • git add / push to publish the initial project on the git repo
  • ./ to build the full war

Create a new project type

If you are not happy with the available project types (standard and custom), you can extend them adding a new folder in project.

The folder will contain two sub-folders:

  • static: for static content, to be copied as is to the project folder
  • templates: for template files, containing project-dependent variables that will be replaced by the createProject script. You can use the following variables:
  • __PROJECTNAME__: \<projectName> parameter value
  • __PROJECTDESCRIPTION__: \<projectDescription> parameter value
  • __PROJECTVERSION__: \<projectVersion> parameter value
  • __REPOURL__: \<gitRepositoryUrl> parameter value

In addition to static and templates, the following files from the root MapStore folder will be copied:

  • .babelrc
  • .editorconfig
  • LICENSE.txt

Update MapStore2 version in a project

To update MapStore2 version enter the MapStore2 folder and pull desired git version. If MapStore2 devDependencies have been changed you can manually update these in the project package.json file or run the script updateDevDeps

npm run updateDevDeps

The script will automatically copy the devDependencies from MapStore2 package.json to the project package.json file. All the project existing devDependencies will be overwritten.

To sync MapStore2 dependencies just run npm install from project root folder.

npm install

Also make sure to follow the migration guidelines here.