How to Contribute New Design Resources to the Design Resources for Developers Repository

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 and adhere to the structural standards outlined in the 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: 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: 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 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).

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).

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:

| [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: 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 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 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 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. 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.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}