You can create new files directly on GitHub in any repository you have write access to.


  • If you try to create a new file in a repository that you don’t have access to, we will fork the project to your user account and help you send a pull request to the original repository after you commit your change.
  • File names created via the web interface can only contain alphanumeric characters and hyphens (-). To use other characters, create and commit the files locally and then push them to the repository.
  1. In your repository, browse to the folder where you want to create a file.
  2. Above the file list, click . The create new file button on GitHub
  3. In the file name field, type the name and extension for the file. To create subdirectories, type the / directory separator. New file name
  4. On the Edit new file tab, add content to the file. Content in new file
  5. To review the new content, click Preview. New file preview button
  6. At the bottom of the page, under "Commit new file," type a short, meaningful commit message that describes the change you made to the file. Commit message for your new file
  7. Below the commit message fields, decide whether to add your commit to the current branch or to a new branch. If your current branch is master, you should choose to create a new branch for your commit and then create a pull request. Commit branch options
  8. Click Propose new file. Commit new file button