---
layout: handbook-page-toc
title: "How to create a directory"
---

## On this page
{:.no_toc .hidden-md .hidden-lg}

- TOC
{:toc .hidden-md .hidden-lg}

To create a directory in your project, you need to use your [shell](https://docs.gitlab.com/ee/gitlab-basics/basic-git-commands.html). You can learn how to [start using Git on the command line](https://docs.gitlab.com/ee/gitlab-basics/start-using-git.html) and the [command line basic commands](https://docs.gitlab.com/ee/gitlab-basics/command-line-commands.html) before reading this documentation.

The following are the basic steps to create a directory through your shell:

Go into the repository or project that you'll be working on:
```
cd NAME-OF-PROJECT
```

Download the latest changes in the project, so that you work on an up-to-date copy:
```
git pull
```

Create a branch (remember you can't add spaces, you need to use a hyphen or underscore):
```
git checkout -b NAME-OF-BRANCH
```

Go into the file where you'd like to add the directory:
```
cd NAME-OF-FILE
```

Create a directory:
```
mkdir NAME-OF-YOUR-NEW-DIRECTORY
```

Then go into the new directory:
```
cd NAME-OF-YOUR-NEW-DIRECTORY
```

Create a README.md or index.md in directory:
```
touch README.md
nano README.md
#### ADD YOUR INFORMATION
#### Press: control + X
#### Type: Y
#### Press: enter
```

Go back one directory or file:
```
cd ../
```

View the changes you've made (it's important to be aware of what's happening and what's the status of your changes):
```
git status
```

Add the changes to later commit (you'll be able to see your changes in red when you type "git status"):
```
git add CHANGES
```

Check the status and you should see the name of your directory in green:
```
git status
```

Add a commit with your changes:
```
git commit -m "DESCRIBE COMMIT IN A FEW WORDS"
```

Send your changes to gitlab.com:
```
git push origin NAME-OF-BRANCH
```