How can I add a README.md file with Xcode?

I just solved the same problem, so allow me to share my finding.

1. From Xcode, select the project root in the Project Navigator.
2. Right click, and select Add Files to <Your Project>...
3. Choose README.md; make sure to uncheck the copy-file option and any group, like this:
4. Click Add.
5. Done.

This is how I did it -

1 - Create a new file by ctrl+click in root folder of the project within xCode.

2 - Once done choose file type other from left pan and then pick empty file. Rename it to Readme.md while saving the file.

3 - The Readme.md file should be created in the root folder as displayed in above screen-shot.

That is it that should do. When you push the code to the repository your Readme.md file should be displayed properly.

B.R

There are basically two questions here. The first is how to add a README.md file and push it to GitHub. touch README.md; git add README.md; git commit -m "added README.md"; git push origin

The second is one of file visibility. I think what you're running into here is that Xcode keeps a file manifest record of sorts for its projects. Try reading through this question: Xcode does not pick up new class files in SVN

Are you adding the file within Xcode or the terminal/finder?