mirror of
https://github.com/maputnik/editor.git
synced 2026-01-20 20:30:01 +00:00
a62db148cd
1. Changed references to point to this new repo 2. Fixed docker image publishing to point to ghcr.io. 3. Remove survey link - the survey is closed and there's no point in keeping it. 4. Remove storybook - Basically a storybook is the ability to look at components and see how they look and interact with them. It's a powerful tool for developing component library with "live" documentation. But it's an overkill for this project and I would like to reduce maintenance costs. Currently all the "stories" are in javascript and not in typescript and it feels like a waste of time to try and maintain it, along with updating the storybook library itself and everything around it.
111 lines
3.9 KiB
Markdown
111 lines
3.9 KiB
Markdown
<img width="200" alt="Maputnik logo" src="https://cdn.jsdelivr.net/gh/maputnik/design/logos/logo-color.png" />
|
|
|
|
# Maputnik
|
|
[][github-action-ci]
|
|
[][license]
|
|
|
|
[github-action-ci]: https://github.com/maplibre/maputnik/actions?query=workflow%3Aci
|
|
[license]: https://tldrlegal.com/license/mit-license
|
|
|
|
A free and open visual editor for the [MapLibre GL styles](https://maplibre.org/maplibre-style-spec/)
|
|
targeted at developers and map designers.
|
|
|
|
|
|
## Usage
|
|
|
|
- :link: Design your maps online at **<https://www.maplibre.org/maputnik/>** (all in local storage)
|
|
- :link: Use the [Maputnik CLI](https://github.com/maplibre/maputnik/wiki/Maputnik-CLI) for local style development
|
|
- In a Docker, run this command and browse to http://localhost:8888, Ctrl+C to stop the server.
|
|
|
|
```bash
|
|
docker run -it --rm -p 8888:8888 ghcr.io/maplibre/maputnik:main
|
|
```
|
|
|
|
## Documentation
|
|
|
|
The documentation can be found in the [Wiki](https://github.com/maplibre/maputnik/wiki). You are welcome to collaborate!
|
|
|
|
- :link: **Study the [Maputnik Wiki](https://github.com/maplibre/maputnik/wiki)**
|
|
- :video_camera: Design a map from Scratch https://youtu.be/XoDh0gEnBQo
|
|
|
|
[](https://youtu.be/XoDh0gEnBQo)
|
|
|
|
## Develop
|
|
|
|
Maputnik is written in typescript and is using [React](https://github.com/facebook/react) and [MapLibre GL JS](https://maplibre.org/projects/maplibre-gl-js/).
|
|
|
|
We ensure building and developing Maputnik works with the [current active LTS Node.js version and above](https://github.com/nodejs/Release#release-schedule).
|
|
|
|
### Getting Involved
|
|
Join the #maplibre or #maputnik slack channel at OSMUS: get an invite at https://slack.openstreetmap.us/ Read the the below guide in order to get familiar with how we do things around here.
|
|
|
|
Install the deps, start the dev server and open the web browser on `http://localhost:8888/`.
|
|
|
|
```bash
|
|
# install dependencies
|
|
npm install
|
|
# start dev server
|
|
npm run start
|
|
```
|
|
|
|
If you want Maputnik to be accessible externally use the [`--host` option](https://vitejs.dev/config/server-options.html#server-host):
|
|
|
|
```bash
|
|
# start externally accessible dev server
|
|
npm run start -- --host 0.0.0.0
|
|
```
|
|
|
|
The build process will watch for changes to the filesystem, rebuild and autoreload the editor.
|
|
|
|
```
|
|
npm run build
|
|
```
|
|
|
|
Lint the JavaScript code.
|
|
|
|
```
|
|
# run linter
|
|
npm run lint
|
|
npm run lint-styles
|
|
```
|
|
|
|
|
|
## Tests
|
|
For E2E testing we use [Cypress](https://www.cypress.io/)
|
|
|
|
[Cypress](https://www.cypress.io/) doesn't starts a server so you'll need to start one manually by running `npm run start`.
|
|
|
|
Now open a terminal and run the following using *chrome*:
|
|
|
|
```
|
|
npm run test
|
|
```
|
|
or *firefox*:
|
|
```
|
|
npm run test -- --browser firefox
|
|
```
|
|
|
|
See the following docs for more info: (Launching Browsers)[https://docs.cypress.io/guides/guides/launching-browsers]
|
|
|
|
You can also see the tests as they run or select which suites to run by executing:
|
|
|
|
```
|
|
npm run cy:open
|
|
```
|
|
|
|
|
|
## Related Projects
|
|
|
|
- [maputnik-dev-server](https://github.com/nycplanning/labs-maputnik-dev-server) - An express.js server that allows for quickly loading the style from any mapboxGL map into mapuntnik.
|
|
|
|
## Sponsors
|
|
|
|
Thanks to the supporters of the **[Kickstarter campaign](https://www.kickstarter.com/projects/174808720/maputnik-visual-map-editor-for-mapbox-gl)**. This project would not be possible without these commercial and individual sponsors.
|
|
You can see this file's history for previous sponsors of the original Maputnik repo.
|
|
Read more about the MapLibre Sponsorship Program at https://maplibre.org/sponsors/.
|
|
|
|
## License
|
|
|
|
Maputnik is [licensed under MIT](LICENSE) and is Copyright (c) Lukas Martinelli and Maplibre contributors.
|
|
As contributor please take extra care of not violating any Mapbox trademarks. Do not get inspired by other map studios and make your own decisions for a good style editor.
|