# How to use 3D Parts GitHub Repo

## Overview

https://youtu.be/_e8vcE2och4

## 3D Models from Adafruit

You can design custom enclosures for your DIY projects using 3D models from Adafruit. These allow you to create designs that feature accurate measurements with precise placement. You can get exact dimensions so you can gauge tolerances without having to guess or rely on measuring parts with calipers.

![3d_printing_cad-explode.gif](https://cdn-learn.adafruit.com/assets/assets/000/114/951/medium640thumb/3d_printing_cad-explode.jpg?1663080985)

## CAD Parts Repo

3D models are available on the Adafruit CAD Parts repository on GitHub.

Download files in formats such STEL, STL and Fusion 360.

Don't see parts you're looking for? Submit a parts request using the issues tab.

Have your own files you'd like to share with the community? Make a pull request to have them merged into the repository!

![3d_printing_github-adafruit-cad-parts.jpg](https://cdn-learn.adafruit.com/assets/assets/000/114/950/medium640/3d_printing_github-adafruit-cad-parts.jpg?1663080713)

## 3D CAD Parts Github

[https://github.com/adafruit/Adafruit\_CAD\_Parts/](https://github.com/adafruit/Adafruit_CAD_Parts/)

![](https://cdn-learn.adafruit.com/assets/assets/000/114/949/medium800/3d_printing_RP2040_Boards.jpg?1663080625)

## Prerequisite Guides

Take a moment to review the following guides for more information on using GitHub.

- [An Introduction to GitHub](https://learn.adafruit.com/an-introduction-to-collaborating-with-version-control/overview)
- [Contribute to CircuitPython on GitHub](https://learn.adafruit.com/contribute-to-circuitpython-with-git-and-github/overview)

# How to use 3D Parts GitHub Repo

## Usage

![](https://cdn-learn.adafruit.com/assets/assets/000/114/952/medium800/3d_printing_github-adafruit-cad-parts.jpg?1663081156)

## 3D Parts GitHub Repo

Click the link below to launch the GitHub repository.

[3D Parts GitHub Repo](https://github.com/adafruit/Adafruit_CAD_Parts)
[https://github.com/adafruit/Adafruit\_CAD\_Parts/](https://github.com/adafruit/Adafruit_CAD_Parts/)

## Folders & Files

Each model resides in a folder that is titled with the product ID. For example, the Adafruit Feather M4 Express is titled as **3857 Feather M4 Express**. 

Click the title to go inside of the folder. Inside the directory are files in formats such as Fusion 360 ( **.f3d** ), STEP ( **.step** ) and STL ( **.stl** ). There's also either a GIF or JPG image that can be viewed by clicking on it.

![3d_printing_github-product-files.jpg](https://cdn-learn.adafruit.com/assets/assets/000/114/953/medium640/3d_printing_github-product-files.jpg?1663081237)

## Search & Browse

You can simply scroll through the list of parts to browse all of the available models.

Use the search feature in your web browse to search for specific files. Normally a keyboard short like command+F or control+F works. Type and enter the product ID or the name of the part to search.

![3d_printing_github-file-list.jpg](https://cdn-learn.adafruit.com/assets/assets/000/114/956/medium640/3d_printing_github-file-list.jpg?1663082953)

## STL Viewer

The Github website features a built-in viewer for STL files. Click on an STL file to view it in the web browser. 

Click and drag using the left mouse button to rotate around the model.

Use the mouse scroll wheel to zoom in and out of the model.

Use the bottom menu to switch between wireframe, surface angle and solid views.

![3d_printing_stl-viewer2.gif](https://cdn-learn.adafruit.com/assets/assets/000/114/954/medium640thumb/3d_printing_stl-viewer2.jpg?1663082718)

## Downloading Files

To download individual files, click on the your desired file format. Look for the download button in the upper right side of the title bar with the file size. 

Depending on the web browser, sometimes STEP files will be displayed as text file. If that happens, try right-clicking on the download button and select **Save Link As**.  

![3d_printing_github-file-download.jpg](https://cdn-learn.adafruit.com/assets/assets/000/114/955/medium640/3d_printing_github-file-download.jpg?1663082871)

## Request Parts

Use the issues tab to submit a parts request.

Click the **New Issue** button to create a new parts request.

In the title include the product ID and name. Write a short description if you'd like and the URL of the product.

Please be considerate when submitting a parts request. Thank you!

![3d_printing_github-part-request.jpg](https://cdn-learn.adafruit.com/assets/assets/000/114/957/medium640/3d_printing_github-part-request.jpg?1663083352)

# How to use 3D Parts GitHub Repo

## Contributing

See the Guide [How to convert Eagle PCBs to 3D Models in Fusion 360](https://learn.adafruit.com/how-to-convert-eagle-pcbs-to-3d-models-in-fusion-360) for the mechanics of modeling a board as a 3D part.

## Contribute with GitHub Desktop

Use the GitHub Desktop app to contribute your models to the Adafruit CAD Parts GitHub repository. Click the link below to download the GitHub Desktop app for your OS.

[Download GitHub Desktop App](https://desktop.github.com/)
## Login

Enter your GitHub username and email address. If you don't have one yet, go ahead and create an account on the GitHub website.

![3d_printing_github-desktop-login.jpg](https://cdn-learn.adafruit.com/assets/assets/000/114/936/medium640/3d_printing_github-desktop-login.jpg?1663073135)

## Clone the Repository

Click on the "Clone a Repository from the internet..." button.

Select the URL tab and enter the website into the text field.

**[https://github.com/adafruit/Adafruit\_CAD\_Parts](https://github.com/adafruit/Adafruit_CAD_Parts)**

Under Local Path, click on the **Choose** button and select a directory for the CAD files to reside in.

Click the **Clone** button when ready.

![3d_printing_github-desktop-url.jpg](https://cdn-learn.adafruit.com/assets/assets/000/114/937/medium640/3d_printing_github-desktop-url.jpg?1663073270)

## Create a Branch

Click on the **Current Branch** tab and then the **New Branch** button.

Type in a desired name for your new branch. This can be your username or anything relevant to your project.

In the Switch Banch dialog, select " **Bring My Changes to New Branch**" and then click the **Switch Branch** button.

![3d_printing_github-desktop-new-branch.jpg](https://cdn-learn.adafruit.com/assets/assets/000/114/938/medium640/3d_printing_github-desktop-new-branch.jpg?1663073559)

## Add Your Files

In your local repository, create a new folder titled with the product ID and the name of the part you'd like to add. Each part should have its own folder.

CAD files should be in the STEP and STL format (F3D file if available). A JPG or GIF image is also recommended.

Enter a summary and description in the changes tab. Click the check boxes for each file to include it in the commit.

If you're using Mac OS, DO NOT include any .DS\_Store files.

Click **Commit to My Branch** when ready.

![3d_printing_github-desktop-add-files.jpg](https://cdn-learn.adafruit.com/assets/assets/000/114/939/medium640/3d_printing_github-desktop-add-files.jpg?1663073866)

Danger: 

## Fork Branch

Select **Fork This Branch** when prompted.

Then, select " **To contribute to the parent project**" in the "How are you planning to use this fork" dialog.

Click **Publish** when ready.

![3d_printing_github-desktop-publish-branch.jpg](https://cdn-learn.adafruit.com/assets/assets/000/114/940/medium640/3d_printing_github-desktop-publish-branch.jpg?1663074398)

![3d_printing_github-desktop-branch-fork.jpg](https://cdn-learn.adafruit.com/assets/assets/000/114/941/medium640/3d_printing_github-desktop-branch-fork.jpg?1663074417)

## Compare & pull request

Go to the web browser and load the Adafruit CAD Parts repository on GitHub.

Click on the **Compare & pull request** button in the top of the part list.

![3d_printing_github-compare-PR.jpg](https://cdn-learn.adafruit.com/assets/assets/000/114/942/medium640/3d_printing_github-compare-PR.jpg?1663074583)

## Open a Pull Request

Verify your summary and description are correct. You can also add any additional details if you'd like.

When ready, click on the **Create pull request** button.

 

![3d_printing_github-open-PR.jpg](https://cdn-learn.adafruit.com/assets/assets/000/114/943/medium640/3d_printing_github-open-PR.jpg?1663074716)

## Committed Pull Request

Congratulations on opening your Pull Request!

If everything went well, you should see a green check mark and a message regarding the branch has no conflicts. 

![3d_printing_github-commited-PR.jpg](https://cdn-learn.adafruit.com/assets/assets/000/114/944/medium640/3d_printing_github-commited-PR.jpg?1663074871)

## Pull Requests

Your new pull request will appear in the Pull Request tab.

The moderators of the repository will be notified when a new pull request has been submitted.

Please allow the moderators time to review your pull request.

![3d_printing_github-pull-requests.jpg](https://cdn-learn.adafruit.com/assets/assets/000/114/945/medium640/3d_printing_github-pull-requests.jpg?1663075019)

## PR successfully merged and closed

You will be notified when your PR has been merged.

Once you're all set, you can safely delete your branch.

Click on the **Delete branch** button to tidy up your pull request.

![3d_printing_github-delete-branch.jpg](https://cdn-learn.adafruit.com/assets/assets/000/114/946/medium640/3d_printing_github-delete-branch.jpg?1663075198)

## Contributed Parts

Your files will be listed in the main repository for everyone to see and have access to download.

Your username will be tied to your files so everyone will know that you added them.

Thank you for contributing to the repository!

![3d_printing_github-your-parts.jpg](https://cdn-learn.adafruit.com/assets/assets/000/114/947/medium640/3d_printing_github-your-parts.jpg?1663075595)


## Related Guides

- [Prop-Maker Lightsaber](https://learn.adafruit.com/lightsaber-featherwing.md)
- [Video Playing 2.1" Round Ornament TFT](https://learn.adafruit.com/2-1-round-ornament-tft.md)
- [Servo Animatronic Tail](https://learn.adafruit.com/servo-animatronic-tail.md)
- [3D Printed Action Figure Selfie](https://learn.adafruit.com/3d-printed-action-figure-selfie.md)
- [Ride & Rock - DIY Bike Stereo System with 20W Speaker](https://learn.adafruit.com/ride-rock-diy-bike-stereo-system-with-20w-speaker.md)
- [Ember 3D Printer](https://learn.adafruit.com/ember-3d-printer.md)
- [3D Printed NeoPixel LED Gas Mask](https://learn.adafruit.com/3d-printed-el-wire-laser-neopixel-led-gas-mask.md)
- [LEGO Compatible Crickit Rover](https://learn.adafruit.com/lego-compatible-crickit-rover.md)
- [Printy Boost: Reimagining a Classic Adafruit Kit](https://learn.adafruit.com/printy-boost-reimagining-a-classic-adafruit-kit.md)
- [CircuitPython Rotary Trinkey Brightness Crank](https://learn.adafruit.com/circuitpython-rotary-trinkey-brightness-crank.md)
- [IoT Moon Phase Guide](https://learn.adafruit.com/moon-phase.md)
- [Blinka LED Sign](https://learn.adafruit.com/blinka-led-sign.md)
- [Ray Gun Blaster](https://learn.adafruit.com/ray-gun-blaster.md)
- [CRICKIT Flippy Robot](https://learn.adafruit.com/crickit-flippy-robot.md)
- [3D Printing on Diffraction Grating Sheets](https://learn.adafruit.com/3d-printing-on-diffraction-grating-sheets.md)