vyshnav-tr/nav2-costmap-filter-editor

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.