how to add folder in github repository

Step-by-Step: Add Folder to GitHub Repository

By Nicole Miller
AD

Embarking on your journey in version control, you've likely found yourself wanting to organize your GitHub repository with folders. They not only help you manage your codebase but also make it easier for collaborators and contributors to navigate your project. Here's a step-by-step guide on how to add a folder to your GitHub repository.

Before we dive in, ensure you have Git installed on your local machine. If not, you can download and install it here. Now, let's get started!

Creating a New Folder Locally

First, let's create a new folder on your local machine. For simplicity, let's call it 'new-folder'.

AD
How to Add a New Folder to an Existing GitHub Repository
How to Add a New Folder to an Existing GitHub Repository
How to create repository on GitHub - The Tech Edvocate
How to create repository on GitHub - The Tech Edvocate
How to Download Files and Folders From GitHub
How to Download Files and Folders From GitHub

To initiate a new folder in your terminal:


mkdir new-folder

Navigating to the Folder

Once created, navigate into your new folder using the 'cd' command:

Beginner’s guide to GitHub: Uploading files and folders to GitHub
Beginner’s guide to GitHub: Uploading files and folders to GitHub
How to Add a New Folder to an Existing GitHub Repository
How to Add a New Folder to an Existing GitHub Repository

cd new-folder

You're now within your new folder and ready to start working within it.

Initializing the Folder for Git

To start tracking changes in this new folder, you need to initialize it with Git:

AD

git init

This command initializes a new Git repository in your current directory.

Adding and Committing the Folder to Your Local Repository

Now that you've initialized the folder, you need to add and commit it to your local repository.

First, add the folder to your Git repository:

AD

git add .

Replace '.' with the name of your folder if you wish to add only that specific folder. The 'git add' command tells Git to start tracking changes in the specified directory or file.

Checking the Status of Your Repo

Before committing, let's check the status of your repository to ensure the folder has been added:


git status

The command 'git status' shows the state of changes in your working directory and staging area.

AD

Committing the Folder

Finally, commit your changes to your local repository:


git commit -m "Commit message"

Replace 'Commit message' with a brief but descriptive message explaining the changes you've made.

Pushing the Folder to Your Remote GitHub Repository

Your folder is now committed to your local repository. Next, let's push these changes to your remote GitHub repository.

First, ensure you have connected your local repository to your remote GitHub repository. If you haven't, you can do so with the following command:


git remote add origin https://github.com/your_username/your_repo.git

Replace 'your_username' and 'your_repo' with your GitHub username and the name of your repository, respectively.

Pushing Your Commits to GitHub

Now, push your commits to GitHub with the following command:


git push -u origin main

Remember to replace 'main' with the name of the branch you're pushing to - it usually is 'main'. The '-u' option sets the upstream branch for your current branch.

Verifying the Changes on GitHub

Finally, head over to your GitHub repository to verify that the new folder has been added. Refresh the page, and you should see your new folder!

And there you have it! You've successfully added a folder to your GitHub repository. Folders are an excellent way to organize your codebase and make collaboration more manageable. Happy coding!

AD