Robotics Enhancement Proposals Official Source

This repository is the offical source of the Robotics Enhancement Proposals (REP) of the Open Source Robotics Alliance Technical Governance Committee.

REP submission process

On October 23rd, 2025 the Open Source Robotics Alliance (OSRA) Technical Governance Comittee (TGC) launched our new REP process. Details on how to submit new REPs can be found in REP-0001:2025. Additional details can be found in our announcement on ROS Discourse. The REP review process is significantly different from most conventional source code repositoires. We recommend you read REP-0001:2025 in its entirety before submitting a pull request..

The full list of REPS in Markdown format can be found in the _posts subdirectory. The website is hosted at reps.openrobotics.org. REP discussions should take place on the Open Robotics Discourse or the Open Robotics Zulip server.

REP numbering scheme

A specification of the REP numbering system can be found in REP-0001:2025.

REP template

A template REP sumbission can be found in REP-0004:2025 - Sample Markdown REP Template.

Building locally

The REP website is built using Jekyll and the Chirpy theme.

To build the website locally:

1. Install Ruby.

   sudo apt install ruby-dev

2. Make Ruby GEMs available in your your path by adding the following to your shell configuration file (e.g. .bashrc):

   export GEM_HOME="$(ruby -e 'puts Gem.user_dir')"
   export PATH="$PATH:$GEM_HOME/bin"

3. Install the required Gems

   gem install bundler jekyll jekyll-theme-chirpy html-proofer

4. Build and serve the site

   bundle exec jekyll serve
   

5. The REP website should now be available at http:/localhost:4000

Using a development container

A development container is available for this repository. To use the development container follow the instructions provided by Visual Studio Code or use GitHub's built-in codespace.