vyshnav-tr/nav2-costmap-filter-editor — explained in plain English
Analysis updated 2026-05-18
Draw keepout zones on a ROS 2 map to stop a robot entering restricted areas.
Create speed limit zones that slow a robot down in specific parts of a map.
Add virtual walls to a map without modifying the physical space.
Export Nav2 ready costmap filter mask files without manual file editing.
| vyshnav-tr/nav2-costmap-filter-editor | alange/tinyclaude | cprecioso/tubecaster | |
|---|---|---|---|
| Stars | 5 | 5 | 5 |
| Language | TypeScript | TypeScript | TypeScript |
| Last pushed | — | — | 2025-03-29 |
| Maintenance | — | — | Stale |
| Setup difficulty | easy | moderate | moderate |
| Complexity | 2/5 | 3/5 | 2/5 |
| Audience | developer | developer | general |
Figures from each repo's GitHub metadata at analysis time.
Nav2 Costmap Filter Editor is a tool for people who work with ROS 2, the Robot Operating System used to control robots like mobile bases and delivery bots. Specifically it helps with Nav2, the navigation system many ROS 2 robots use to move around a space without hitting things. Robots that use Nav2 rely on maps that mark which areas are safe to drive through and which are restricted, for example keepout zones a robot must avoid, sections where its speed should be limited, or virtual walls that block a path even though nothing physical is there. Normally, creating these restriction maps involves editing image files by hand. This project replaces that with a visual, browser based editor. You load your existing map files, a .pgm image and a .yaml metadata file that ROS 2 already uses, and then draw shapes directly on top of the map: rectangles, circles, or free form polygons. Each shape can be marked as a keepout zone, a speed limit zone with a chosen percentage, or a wall. The editor supports moving, resizing, and rotating shapes, along with undo and redo, panning, zooming, and keyboard shortcuts for common actions. Once the zones are drawn, the tool exports a zip file containing the updated map along with the correctly formatted keepout and speed filter mask files that Nav2 expects. These files are meant to be dropped directly into a Nav2 costmap filters setup, so there is no manual conversion step afterward. A key detail is that everything runs entirely in the browser. There is no backend server involved, and no map data is uploaded anywhere, so users can try it through a hosted live version without installing anything, or run it locally with npm install and npm run dev. The project is built with Next.js, React, and TypeScript, styled with Tailwind CSS, and uses HTML Canvas for drawing the map and zones. It is released under the MIT license.
A browser based, backend free editor for drawing keepout, speed limit, and wall zones onto ROS 2 Nav2 costmap maps, then exporting ready to use mask files.
Mainly TypeScript. The stack also includes Next.js, React, TypeScript.
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
Verify against the repo before relying on details.