# How to contribute to Libraries?

**URL:** <https://librepcb.discourse.group/t/how-to-contribute-to-libraries/140>\
**Category:** Libraries\
**Created:** [October 2, 2019, 10:51am UTC](https://librepcb.discourse.group/t/how-to-contribute-to-libraries/140 "2019-10-02T10:51:08Z")\
**Posts on this page:** 1\
**Showing post:** 3

<div class="post-metadata">

**Author:** ![dbrgn](https://yyz2.discourse-cdn.com/free1/user_avatar/librepcb.discourse.group/dbrgn/32/25_2.png) [@dbrgn](https://librepcb.discourse.group/u/dbrgn)\
**Post date:** [October 2, 2019, 8:31pm UTC](https://librepcb.discourse.group/t/how-to-contribute-to-libraries/140/3 "2019-10-02T20:31:56Z")

</div>

Thanks for bringing this up. We definitely need a library contribution guide.

I’ll start with a quick overview. This workflow currently assumes that you are familiar with [git](https://git-scm.com/), [GitHub](https://github.com/) and the command line.

1. Fork the appropriate repository on GitHub: [https://github.com/librepcb-libraries](https://github.com/librepcb-libraries)
2. Make sure that the library is not already downloaded as a remote library. If it is, open the library editor to see the storage path and delete that directory in `LibrePCB-Workspace/v0.1/libraries/remote/`.  
 ![screenshot](https://global.discourse-cdn.com/free1/uploads/librepcb1/original/1X/f58a14736fc746b90ae3d25082a12241b03d66e2.png)
3. Ensure that the directory `LibrePCB-Workspace/v0.1/libraries/local/` exists
4. Clone the forked library to your local library directory using git:

```auto
$ git clone git@github.com:your-username/LibrePCB_Base.lplib.git \
    LibrePCB-Workspace/v0.1/libraries/local/

```

5. In the local library directory, create a new branch:

```auto
$ git checkout -b your-new-feature

```

6. Edit the library using the library editor. Add new library elements according to the [library conventions](https://docs.librepcb.org/#libraryconventions). If you edit any existing library elements, make sure to increment the version number.
7. Commit the changes, push the branch to your GitHub fork
8. Create a pull request on GitHub against the original repository and wait for a review.

I hope this helps! Let us know if you have any questions, we’ll try to help you along.

---

_[View the full topic](https://librepcb.discourse.group/t/how-to-contribute-to-libraries/140)._