Skip to content

sensebox/openSenseMap

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Thiemann96Eric Thieme-Garmann
and
Eric Thieme-Garmann
Mar 18, 2025
549a793 · Mar 18, 2025
Apr 17, 2023
Mar 18, 2025
Jan 11, 2018
Nov 22, 2017
May 24, 2014
Jul 15, 2016
May 24, 2014
Mar 21, 2022
Jan 13, 2021
Mar 21, 2022
May 24, 2014
Jan 11, 2018
Oct 30, 2023
Jul 30, 2017
Apr 6, 2022
Apr 28, 2015
Apr 8, 2022
Oct 30, 2023
Mar 21, 2022
Oct 30, 2023
Oct 30, 2023
Jul 30, 2017

Repository files navigation

openSenseMap

Commitizen friendly

This repository contains the code of the openSenseMap frontend running at https://opensensemap.org. To get more information about openSenseMap and senseBox visit the before mentioned links or have a look at this video or read the openSenseMap chapter in our documentation. openSenseMap is part of the senseBox project.

Originally, this frontend has been built as part of the bachelor thesis of @mpfeil at the ifgi (Institute for Geoinformatics, WWU Münster) and is currently maintained by @mpfeil.

The easiest way to get up and running with your own copy is clicking the Deploy to Netlify button below. It will clone the repository into your own account, and deploy the site to Netlify. It is going to ask for Maptiles url and API endpoint. Please use the default values listed under configuration or use your own.

Deploy to Netlify

Configuration

You can configure the API endpoint and/or map tiles using the following environmental variables:

ENV Default value
OPENSENSEMAP_API_URL https://api.testing.opensensemap.org
OPENSENSEMAP_CMS_URL <YOUR_DIRECTUS_CMS_URL>
OPENSENSEMAP_STYLE_URL <YOUR_MAPBOX_STYLE_URL>
OPENSENSEMAP_ACCESS_TOKEN <YOUR_MAPBOX_ACCESS_TOKEN>

You can set them in your terminal or create a file called .env and set the values.

Development

  • Have Node.js v10, grunt and bower installed
  • Check out a branch for your feature (git checkout my-aweseome-feature)
  • Run npm install and npx bower install
  • Run frontend in development mode (npx grunt serve)
  • Commit your changes to your branch and push it to your fork
  • Create a pull request against the master branch

See also: CONTRIBUTING

Release

To release a new version of the openSenseMap frontend do the following:

  • Run npm run release on master branch
  • Run git push --follow-tags origin master
  • Create new release on Github Release

Related projects

Services

Deployment

Technologies

Organization

Branches

  • master (runs on testing server)
    • Is used for production container build tags

Docker

openSenseMap including openSenseMap-API

For installing openSenseMap and openSenseMap-API with Docker check out our oSeM-compose repository.

openSenseMap

To build just openSenseMap you can run: docker build -t osem .

Following build-args are availble:

Build Arg Default value
OPENSENSEMAP_API_URL https://api.opensensemap.org
OPENSENSEMAP_CMS_URL <YOUR_DIRECTUS_CMS_URL>
OPENSENSEMAP_STYLE_URL <YOUR_MAPBOX_STYLE_URL>
OPENSENSEMAP_ACCESS_TOKE <YOUR_MAPBOX_ACCESS_TOKEN>

License

MIT - Matthias Pfeil 2015 - now