Skip to content

Instantly share code, notes, and snippets.

Show Gist options
  • Select an option

  • Save cvega/63cd20c2b9ca655a1f7f4899004a28aa to your computer and use it in GitHub Desktop.

Select an option

Save cvega/63cd20c2b9ca655a1f7f4899004a28aa to your computer and use it in GitHub Desktop.
Storing Images and Demos in your Repo

Storing Images and Demos in your Repo

In this quick walkthough you'll learn how to create a separate branch in your repo to house your screenshots and demo gifs for use in your master's readme.

How to

1. Create a new branch

Create a new branch in your repo by using git checkout --orphan assets

This will create and switch you to a new branch called "assets". The --orphan flag creates a new branch but without any prior commits. However it does still keep the working tree and index.

2. Remove files from the working tree

git rm -rf .

We remove all files from the working tree since we do not want anything but our screenshots and images in this branch.

You can also check what branch you are on anytime by using git branch. The branch with the * next to it is the current branch.

3. Add your images and screenshots and commit the change

git add screenshot.png demo.gif logo.png

git commit -m "Added Assets"

4. Finally push your changes

git push origin assets

Use the images in your README

You can now use ![Demo Animation](../assets/demo.gif?raw=true) in your README to have the gif display on your master's readme.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment