/geoext3

A JavaScript framework that combines the GIS functionality of OpenLayers with all features of the ExtJS library

Primary LanguageJavaScriptOtherNOASSERTION

GeoExt 3

JavaScript Toolkit for Rich Web Mapping Applications.

Build Status Coverage Status dependencies Status devDependencies Status Greenkeeper badge

GeoExt logo

GeoExt is Open Source and enables building desktop-like GIS applications through the web. It is a JavaScript framework that combines the GIS functionality of OpenLayers with the user interface savvy of the ExtJS library provided by Sencha.

Version 3 of GeoExt is the successor to the GeoExt 2.x-series and is built atop the newest official installments of its base libraries; OpenLayers (v3.x and v4.x) and ExtJS 6.

We are trying hard to keep up with developments on both our parent libraries. The current state of GeoExt is compatible with ExtJS 6.2.0 and OpenLayers 4.3.x. This state is released as GeoExt v3.1.0.

OpenLayers ExtJS GeoExt
3.20.1 6.2.0 3.0.0
3.20.1 / 4.3.x 6.2.0 3.1.0

More information on GeoExt 3

Have a look at the official homepage: https://geoext.github.io/geoext3/

You will find examples, API documentation (with and without inherited functionality from ExtJS), links to mailinglists and more over there.

What you see on https://geoext.github.io/geoext3/ are the contents of the gh-pages-branch. If you encounter anything that should be fixed, please issue a pull request against that branch and we will merge it as soon as possible.

How to use GeoExt 3 inside your Sencha app

You can use GeoExt 3 either via the sencha cmd package mechanism, or (if you want the latest and greatest), you can use it from a git clone of this repository.

We usually tend to go the git way, so we have full control over which state of GeoExt is in our apps.

Recommended: From a git clone of the repository

Just clone the repository into your project (manually or as a git submodule, e.g.) and adjust the classpath in you app.json like below.

    "classpath": [
        "app",
        "${toolkit.name}/src",
        "./lib/geoext3/src"
    ]

In the snippet above, lib/geoext3 is a clone of the GeoExt repo.

Alternatively: As a sencha cmd package

The released versions of GeoExt 3 are published as ExtJS package. They can be used as any other ExtJS package, taking advantage of Sencha cmd.

In a terminal where you have the sencha cmd available, issue:

sencha package repo add GeoExt http://geoext.github.io/geoext3/cmd/pkgs

To use this package in a Sencha app just add "GeoExt" to the "requires"-array in your app.json:

    "requires": [
        "GeoExt"
    ],

To help with your first GeoExt 3 project, follow the instructions provided to build a GeoExt 3 Universal app. This app runs on the desktop and on mobile.

Examples

Classic Toolkit

https://geoext.github.io/geoext3/master/examples/component/map.html

Modern Toolkit

Want to contribute? Yes, please 😀

Read the hints for developers to get started. We look forward to your contributions!

Initial Codesprint

To kickstart the new GeoExt 3 project a code sprint has been done in Bonn from 17th to 19th of June 2015. For more informations check the following links: Code sprint WIKI page, Official blog post of code sprint day 1, Official blog post of the code sprint days 2 and 3