{"id":46109669,"url":"https://github.com/conterra/mapapps-4-developers","last_synced_at":"2026-03-01T22:02:07.803Z","repository":{"id":24080811,"uuid":"100579842","full_name":"conterra/mapapps-4-developers","owner":"conterra","description":"The map.apps for Developers project is a starting point for programming custom bundles and themes. Use this project as a blueprint for starting your own map.apps project.","archived":false,"fork":false,"pushed_at":"2026-02-09T17:17:56.000Z","size":1231,"stargazers_count":11,"open_issues_count":0,"forks_count":8,"subscribers_count":9,"default_branch":"master","last_synced_at":"2026-02-09T19:55:18.559Z","etag":null,"topics":["mapapps"],"latest_commit_sha":null,"homepage":"","language":"Less","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/conterra.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2017-08-17T08:23:38.000Z","updated_at":"2025-11-28T10:52:32.000Z","dependencies_parsed_at":"2024-03-12T11:56:19.012Z","dependency_job_id":"872d000b-ba7f-49b9-a49c-aae70e261401","html_url":"https://github.com/conterra/mapapps-4-developers","commit_stats":null,"previous_names":[],"tags_count":44,"template":false,"template_full_name":null,"purl":"pkg:github/conterra/mapapps-4-developers","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/conterra%2Fmapapps-4-developers","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/conterra%2Fmapapps-4-developers/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/conterra%2Fmapapps-4-developers/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/conterra%2Fmapapps-4-developers/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/conterra","download_url":"https://codeload.github.com/conterra/mapapps-4-developers/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/conterra%2Fmapapps-4-developers/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29986241,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T21:06:37.093Z","status":"ssl_error","status_checked_at":"2026-03-01T21:05:45.052Z","response_time":124,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["mapapps"],"created_at":"2026-03-01T22:02:06.325Z","updated_at":"2026-03-01T22:02:07.803Z","avatar_url":"https://github.com/conterra.png","language":"Less","funding_links":[],"categories":[],"sub_categories":[],"readme":"# map.apps for Developers\n\nThis project is a starting point for programming custom map.apps bundles and themes. It contains examples for common tasks such as building widgets with Vue.js or creating your own custom themes.\nYou may use this project as a blueprint for starting your own map.apps project.\n\nSince both Typescript and Javascript can be used to implement bundles, this project contains two bundles with the same functionality, `sample_camera` implemented in Typescript and `sample_camera_js` implemented in Javascript.\nInitially only the `sample_camera` bundle is included in the `Demo` sample app.\n\nFor detailed documentation on how to use map.apps for Developers to extend map.apps, see the [map.apps Developer's Guide](https://docs.conterra.de/en/mapapps/latest/developersguide/getting-started/).\n\n## Software Requirements\n\n- Java \u003e= 17\n- Maven \u003e= 3.9.0\n- pnpm \u003e= 10.20\n\n## Quick start\n\nClone this project and ensure that you have all required dependencies installed correctly (see [Documentation](https://docs.conterra.de/en/mapapps/latest/developersguide/getting-started/set-up-development-environment.html)).\n\nThen run the following commands from the project root directory to start a local development server:\n\n```bash\n# install all required node modules\n$ mvn initialize\n\n# start dev server\n$ mvn compile -Denv=dev -Pinclude-mapapps-deps\n\n# run unit tests\n$ mvn test -P run-js-tests,include-mapapps-deps\n```\n\nTo execute the tests in your browser, open \u003chttp://localhost:9090/js/tests/runTests.html\u003e (may be on a different port depending on your configuration).\n\nFor more details refer to the [Developer's Guide](https://docs.conterra.de/en/mapapps/latest/developersguide/getting-started/).\n\n## End-to-end browser tests\n\nWe have prepared some sample end-to-end browser tests for you in the file [sample_camera.spec.ts](src/test/end-to-end/sample_camera.spec.ts).\nThey are based on the [Playwright](https://playwright.dev/) framework.\n\nIf you like to run the tests, you need to install Playwright and its dependencies at first:\n\n```bash\n# Install playwright\npnpx playwright install --with-deps\n```\n\nAfter that, start the development server and run the tests:\n\n```bash\n# start dev server\nmvn compile -Denv=dev -Pinclude-mapapps-deps\n# run end-to-end tests\npnpm run e2e-test\n```\n\nIn headed mode test browser are shown during the test execution.\nTo run the tests in headed mode, execute:\n\n```bash\n# run end-to-end tests headed\npnpm run e2e-test:headed\n```\n\nWe also recommend installing the VS Code Extension for Playwright, which allows you to run and debug tests directly in the IDE.\n\nFor details about end-to-end testing refer to the [Developer's Guide](https://docs.conterra.de/en/mapapps/latest/developersguide/guides/testing/end-to-end-testing.html).\n\n## Updating from older versions\n\n### from 4.20.2 to 4.20.3\n\nSee [Changelog](./CHANGELOG.md#4203---10022026)\n\n### from 4.20.0 to 4.20.2\n\nSee [Changelog](./CHANGELOG.md#4202---28112025)\n\n### from 4.19.3 to 4.20.0\n\nSee [Changelog](./CHANGELOG.md#4200---19112025)\n\n### from 4.19.2 to 4.19.3\n\nSee [Changelog](./CHANGELOG.md#4193---11072025)\n\n### from 4.19.1 to 4.19.2\n\nSee [Changelog](./CHANGELOG.md#4192---06052025)\n\n### from 4.19.0 to 4.19.1\n\nSee [Changelog](./CHANGELOG.md#4191---14022025)\n\n### from 4.18.3 to 4.19.0\n\nSee [Changelog](./CHANGELOG.md#4190---21012025)\n\n### from 4.18.2 to 4.18.3\n\nSee [Changelog](./CHANGELOG.md#4183---07102024)\n\n### from 4.18.1 to 4.18.2\n\nSee [Changelog](./CHANGELOG.md#4182---19072024)\n\n\n### from 4.18.0 to 4.18.1\n\nSee [Changelog](./CHANGELOG.md#4181---23052024)\n\n### from 4.17.0 to 4.18.0\n\nSee [Changelog](./CHANGELOG.md#4180---17052024)\n\n### from 4.16.0 to 4.17.0\n\nSee [Changelog](./CHANGELOG.md#4170---16022024)\n\n### from 4.15.1 to 4.16.0\n\nSee [Changelog](./CHANGELOG.md#4160---11012024)\n\n### from 4.15.0 to 4.15.1\n\nSee [Changelog](./CHANGELOG.md#4151---06092023)\n\n### from 4.14.3 to 4.15.0\n\nNote here a bigger change inside the `pom.xml` and `gulpfile.js` happened due to the introduction of browsersync as dev server and the support for rollup based builds.\nPlease compare the files not all changes are documented in detail.\n\nSee [Changelog](./CHANGELOG.md#4150---11052023)\n\n### from 4.14.2 to 4.14.3\n\nSee [Changelog](./CHANGELOG.md#4143---20032023)\n\n### from 4.14.1 to 4.14.2\n\nSee [Changelog](./CHANGELOG.md#4142---24012023)\n\n### from 4.14.0 to 4.14.1\n\nSee [Changelog](./CHANGELOG.md#4141---01122022)\n\n### from 4.13.1 to 4.14.0\n\nSee [Changelog](./CHANGELOG.md#4140---28102022)\n\n### from 4.13.0 to 4.13.1\n\nSee [Changelog](./CHANGELOG.md#4131---06042022)\n\n### from 4.12.3 to 4.13.0\n\nSee [Changelog](./CHANGELOG.md#4130---29032022)\n\n### from 4.12.2 to 4.12.3\n\nSee [Changelog](./CHANGELOG.md#4123---15122021)\n\n### from 4.12.1 to 4.12.2\n\nSee [Changelog](./CHANGELOG.md#4122---13122021)\n\n### from 4.12.0 to 4.12.1\n\nSee [Changelog](./CHANGELOG.md#4121---10112021)\n\n### from 4.11.1 to 4.12.0\n\nSee [Changelog](./CHANGELOG.md#4120---2021-08-31)\n\n### from 4.11.0 to 4.11.1\n\nSee [Changelog](./CHANGELOG.md#4111)\n\n### from 4.10.1 to 4.11.0\n\nSee [Changelog](./CHANGELOG.md#4110)\n\n### from 4.10.0 to 4.10.1\n\nSee [Changelog](./CHANGELOG.md#4100---2020-12-09)\n\n### from 4.9.2 to 4.10.0\n\nSee [Changelog](./CHANGELOG.md#4100---2020-12-08)\n\n### from 4.9.1 to 4.9.2\n\nSee [Changelog](./CHANGELOG.md#492---2020-10-06)\n\n### from 4.9.0 to 4.9.1\n\nSee [Changelog](./CHANGELOG.md#491---2020-09-04)\n\n### from 4.8.4 to 4.9.0\n\nSee [Changelog](./CHANGELOG.md#490---2020-08-18)\n\n### from 4.8.3 to 4.8.4\n\nSee [Changelog](./CHANGELOG.md#484---2020-05-20)\n\n### from 4.8.2 to 4.8.3\n\n1. Adjust the `mapapps.version` property in `./pom.xml` to `4.8.3`\n2. Adjust the versions in `devDependencies` in `./package.json` according to the list below:\n    - \"ct-mapapps-gulp-js\": \"^0.3.6\"\n\n### from 4.8.1 to 4.8.2\n\n1. Adjust the `mapapps.version` property in `./pom.xml` to `4.8.2`\n2. Change the requirement `babel-polyfill` to `apprt-polyfill` in the `./pom.xml` and `src/test/webapp/js/tests/test-init.js`.\n3. Replace `$apprt.load` and `$apprt.lauchAppFromParam` by `$apprt.startApp` in the `src/test/webapp/index.html`\n\n### from 4.8.0 to 4.8.1\n\n1. Adjust the `mapapps.version` property in `./pom.xml` to `4.8.1`\n\n### from 4.7.2 to 4.8.0\n\n1. Adjust the `mapapps.version` property in `./pom.xml` to `4.8.0`\n2. Adjust the `ct.jsregistry.version` property in `./pom.xml` to `1.3.4`\n3. Adjust the versions in `devDependencies` in `./package.json` according to the list below:\n    - \"ct-mapapps-gulp-js\": \"^0.2.5\"\n\n### from 4.7.1 to 4.7.2\n\n1. Adjust the `mapapps.version` property in `./pom.xml` to `4.7.2`\n2. Adjust the `ct.jsregistry.version` property in `./pom.xml` to `1.3.2`\n3. Add the version hint `\u003cversion\u003e${ct.jsrt-test.version}\u003c/version\u003e` for dependencies `ct-jsrt-test-intern` and `ct-jsrt-test-uitest` in `pom.xml`\n4. Update the Gulpfile and remove the dev dependencies from `gulpfile.js`. For details see [commit](https://github.com/conterra/mapapps-4-developers/commit/c974a74a08a70316204d5c09aee22f8d39c70446)\n\n### from 4.7.0 to 4.7.1\n\n1. Adjust the `mapapps.version` property in `./pom.xml` to `4.7.1`\n2. Adjust the `ct.jsregistry.version` property in `./pom.xml` to `1.3.1`\n\n### from 4.6.1 to 4.7.0\n\n1. Adjust the `mapapps.version` property in `./pom.xml` to `4.7.0`\n2. Adjust the `ct.jsregistry.version` property in `./pom.xml` to `1.3.0`\n3. Adjust the versions in `devDependencies` in `./package.json` according to the list below:\n    - \"eslint-config-ct-prodeng\": \"^1.0.5\"\n    - \"vue-template-compiler\": \"2.6.6\"\n\n### from 4.6.0 to 4.6.1\n\n1. Adjust the `mapapps.version` property in `./pom.xml` to `4.6.1`\n\n### from 4.5.0 or below to 4.6.0\n\n1. Adjust the `mapapps.version` property in `./pom.xml` to `4.6.0`\n2. Adjust the versions in `devDependencies` in `./package.json` according to the list below:\n    - \"ct-mapapps-gulp-js\": \"~0.1.3\"\n    - \"vue-template-compiler\": \"2.5.17\"\n3. Go to `./src/test/webapp/index.html` and replace the `corsEnabledServers: [\"@@mapapps.remote.base@@\"]` with `trustedServers: [\"@@mapapps.remote.base@@\"]` inside the apprt request configuration object.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fconterra%2Fmapapps-4-developers","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fconterra%2Fmapapps-4-developers","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fconterra%2Fmapapps-4-developers/lists"}