How to Create a Folder Inside a GitHub Repository?

Creating a well-organized folder structure in your GitHub repository is crucial for keeping your codebase organized and easy to navigate. Adding folders allows you to separate files by purpose, such as src, docs, or assets, making it easier for team members and contributors to find what they need.

In this blog, we’ll walk through the methods to create folders within a GitHub repository, both directly on GitHub and using Git on your local machine.

Method 1: Create a Folder Directly on GitHub

Creating a folder directly on GitHub is quick and straightforward if you need to make simple structural changes without using a Git client or command line.

Step 1: Navigate to Your Repository

1. Log into your GitHub account.
2. Go to the repository where you want to create the folder.
3. Ensure you have the necessary permissions to add files and folders to the repository.

Step 2: Open the File Creation Interface

1. On your repository’s main page, click the Add file button.
2. Select Create new file from the dropdown.

Step 3: Specify the Folder Name

1. In the filename text box, type the name of the folder you want to create, followed by a forward slash (/).

• For example, if you want to create a folder named docs, type docs/.

1. GitHub will recognize the forward slash as an indicator to create a folder and keep the file creation interface open within that folder.

Step 4: Add a File to the Folder

1. After specifying the folder name, type the name of the file you want to add in that folder (e.g., README.md or index.html).
2. Enter any placeholder content or information you want in the file.

Note: GitHub only creates a folder if it contains a file, as empty folders cannot be committed directly in Git. Adding a placeholder file, such as README.md, ensures the folder will be created.

Step 5: Commit the New Folder and File

1. Scroll down to the Commit new file section.
2. Add a commit message describing the change (e.g., “Add docs folder with README”).
3. Select whether to commit directly to the main branch or create a new branch and start a pull request.
4. Click Commit new file.

Your new folder will now appear in the repository, containing the placeholder file.

---

Method 2: Create a Folder Using Git Locally and Push to GitHub

If you’re already working on your project locally, or if you need to create multiple folders and files, using Git on your local machine can be more efficient.

Step 1: Open Your Terminal and Navigate to Your Repository

Open your terminal or command line interface, and navigate to the repository’s directory:

cd path/to/your-repository

Step 2: Create a New Folder

Use the mkdir command to create a new folder:

mkdir folder-name

Replace folder-name with the desired name of your folder. For example, to create a docs folder, you’d type:

mkdir docs

Tip: You can create nested folders by specifying the full path, such as mkdir src/components.

Step 3: Add a File to the Folder

Once the folder is created, navigate into it and create a new file. You can use a text editor or the touch command to create a file:

cd folder-name
touch placeholder.txt

Replace placeholder.txt with the name of your file, such as README.md. You can edit this file in any text editor if you want to add specific content.

Step 4: Stage and Commit the Changes

After adding the new folder and file, stage and commit the changes:

git add .
git commit -m "Add folder-name folder with placeholder file"

Make sure to replace folder-name with the actual name of the folder you created.

Step 5: Push the Changes to GitHub

Finally, push your commit to the remote repository on GitHub:

git push origin main

Replace main with the name of the branch if you’re working on a different branch.

---

Best Practices for Organizing Folders in GitHub

• Use Meaningful Folder Names: Choose descriptive names that reflect the content, such as src for source files, docs for documentation, and tests for test files.
• Keep Your Structure Simple: Avoid unnecessary nested folders to keep your repository easy to navigate.
• Add README Files: If a folder contains multiple files or important instructions, include a README.md to explain its purpose.
• Organize by Functionality: Group files by their function or purpose within the project. For instance, you might have assets for images and CSS files, config for configuration files, and scripts for automation scripts.

---

Summary

Creating folders in a GitHub repository is essential for organizing your project’s structure and improving its readability. You can easily create folders directly on GitHub for quick updates or use Git on your local machine for more complex changes. By following the steps in this guide and using best practices, you’ll be able to maintain a well-organized and accessible repository on GitHub.