Creating a Pull Request
Before creating a pull request, make sure you have:
1. Validated your changes (no errors should remain)
2. Sorted your data using the WebUI or python -m ofd script style_data
3. Pushed your changes to GitHub
Method 1: Quick Pull Request
- Go to the pull requests tab of the main database
- If you've recently pushed changes, a yellow banner will appear
-
Click the "Compare & pull request" button

-
You'll be brought to a page to create your pull request:
- Change the title to describe what you've changed (e.g., "Add Elegoo Red PLA variant")
-
Write a short description explaining your changes

-
Click "Create pull request"
- A maintainer will review your changes and either merge them or provide feedback
Method 2: Alternative Method
If the yellow banner doesn't appear, follow these steps:
-
Go to your GitHub profile and click on "Repositories"

-
Search for your forked version of the database

-
Click on the database, then click the "Pull requests" tab

-
Click the "New Pull request" button

-
Find and select your branch on the right side

-
Click "Create pull request"

-
Fill in the title and description, then click "Create pull request"

-
Wait for a maintainer to review and merge your changes, or be ready to address any feedback!
Using Pull Request Templates
When creating a pull request, you can use one of our templates to help structure your submission:
- Data Addition - Use when adding new brands, materials, filaments, variants, or stores
- Includes checklists for validation and data quality
-
Ensures you've sorted your data before submitting
-
WebUI Changes - Use when making changes to the web interface code
- For developers modifying the WebUI application
To use a template, look for the "Choose a template" option when creating your PR, or find them in the .github/PULL_REQUEST_TEMPLATE/ folder.