# How to Contribute New Design Resources to the Design Resources for Developers Repository > Contribute design resources to bradtraversy/design-resources-for-developers. Submit a pull request with a formatted title and resource URL to share your valuable assets. - Repository: [Brad Traversy/design-resources-for-developers](https://github.com/bradtraversy/design-resources-for-developers) - Tags: how-to-guide - Published: 2026-03-04 --- **To contribute new design resources to the bradtraversy/design-resources-for-developers repository, submit a single-resource pull request with the formatted title `[Resource Name] -> [Section Name]` and include the resource URL in the description.** The **design-resources-for-developers** repository is a curated, markdown-based collection of free design assets maintained by Brad Traversy. To contribute new design resources effectively, you must follow the specific workflow defined in the project's [`contributing.md`](https://github.com/bradtraversy/design-resources-for-developers/blob/main/contributing.md) and adhere to the structural standards outlined in the main [`readme.md`](https://github.com/bradtraversy/design-resources-for-developers/blob/main/readme.md). ## Understanding the Repository Structure Before you contribute new design resources, familiarize yourself with the key files that govern the contribution process. ### Key Files Overview The repository relies on two primary documents for contributions: - **[`contributing.md`](https://github.com/bradtraversy/design-resources-for-developers/blob/main/contributing.md)**: Contains the step-by-step contribution workflow, PR title format, and validation checklist (located at `https://github.com/bradtraversy/design-resources-for-developers/blob/master/contributing.md`) - **[`readme.md`](https://github.com/bradtraversy/design-resources-for-developers/blob/main/readme.md)**: Holds the master list of design resources organized by category sections such as `## UI Graphics`, `## Fonts`, and `## Icons` (located at `https://github.com/bradtraversy/design-resources-for-developers/blob/master/readme.md`) ## Step-by-Step Contribution Workflow To successfully contribute new design resources, follow this four-step process as defined in the [`contributing.md`](https://github.com/bradtraversy/design-resources-for-developers/blob/main/contributing.md) guidelines. ### Prepare a Single-Resource Entry Each pull request should contain **only one** new resource. This constraint keeps reviews quick and makes the changelog easier to read (see line 3 of the contributing guidelines). Place the entry in the correct section of the README. The section headings are identified by markdown anchors such as `## UI Graphics` (see lines 19-23 of the README). ### Format the Pull Request Title The PR title must include the resource name and the target section, formatted exactly as: ``` [Resource Name] -> [Section Name] ``` For example, from the guidelines: `[Tailwind CSS] -> [CSS Frameworks]` (lines 5-6 of [`contributing.md`](https://github.com/bradtraversy/design-resources-for-developers/blob/main/contributing.md)). ### Add the Resource URL to the Description In the PR description, add a line specifying the resource URL: ``` Link: https://example.com/ ``` This allows reviewers to quickly open the resource without copy-pasting (lines 8-9 of the guidelines). ### Validate the Resource Double-check that the resource is truly free, has no hidden fees, and is still publicly accessible before submitting (line 11 of [`contributing.md`](https://github.com/bradtraversy/design-resources-for-developers/blob/main/contributing.md)). ## Code Examples for Contributors Use these templates when preparing your contribution. ### Markdown Table Row Format Resources are displayed in markdown tables. Format your entry as follows: ```markdown | [Example UI Kit](https://example.com/ui-kit) | A free, responsive UI kit with components for React and Vue | ``` Place this line under the appropriate table in the README (e.g., after the existing rows for UI Graphics). ### Pull Request Title Example ``` [Example UI Kit] -> [UI Graphics] ``` ### Pull Request Description Example ``` Link: https://example.com/ui-kit ``` ## Summary - **Contribute new design resources** by submitting a single-resource pull request to the `bradtraversy/design-resources-for-developers` repository. - Follow the workflow defined in [`contributing.md`](https://github.com/bradtraversy/design-resources-for-developers/blob/main/contributing.md): one resource per PR, formatted title `[Resource Name] -> [Section Name]`, and include `Link: URL` in the description. - Place entries in the correct markdown table within [`readme.md`](https://github.com/bradtraversy/design-resources-for-developers/blob/main/readme.md) under headings like `## UI Graphics` or `## Fonts`. - Validate that resources are free and publicly accessible before submitting. ## Frequently Asked Questions ### How many resources can I add in a single pull request? You must submit **only one** new resource per pull request. This rule, specified in line 3 of the [`contributing.md`](https://github.com/bradtraversy/design-resources-for-developers/blob/main/contributing.md) file, ensures faster review cycles and cleaner changelog history. ### What happens if I format the pull request title incorrectly? Pull requests with improperly formatted titles (not following the `[Resource Name] -> [Section Name]` convention) will likely be rejected or require revision. The maintainers use this strict format to automate categorization and maintain consistency across the repository. ### Can I contribute paid design resources to the repository? No. According to line 11 of the [`contributing.md`](https://github.com/bradtraversy/design-resources-for-developers/blob/main/contributing.md) guidelines, all submitted resources must be **truly free** with no hidden fees. The repository specifically curates free design assets for developers, so paid or freemium resources with paywalls are not accepted. ### Where do I place the new resource entry in the README? Place the entry in the markdown table under the appropriate section heading in [`readme.md`](https://github.com/bradtraversy/design-resources-for-developers/blob/main/readme.md). For example, if contributing a font, add the table row under the `## Fonts` section. The repository uses markdown anchors like `## UI Graphics` to organize resources by category.