Asset Management

GitPitch slideshow presentations often rely on visual assets such as architecture diagrams, charts, background images, logos and in some cases even video. With the exception of video, these are the same types of assets often found within traditional GitHub README and Wikis.

However it is important to understand that GitHub is not designed or intended to be used as a CDN for binary assets, especially large assets such as video.

If your GitPitch slideshow presentation has a dependency on large binary assets we strongly encourage linking to your assets hosted on dedicated file hosting services, such as Dropbox, Box, iCloud, or video hosting services such as YouTube or Vimeo.

You might also want to consider using dedicated CDN services for your images and videos such as Amazon CloudFront or Cloudinary that offer generous free plans at the time of writing.

Regardless of where you host your assets we recommend using size optimized assets for use on the Web, such as compressed, lossless image formats etc. To help you do just that we have released a simple command line tool on GitHub called the asset-optimizer which you can use to quickly optimize all of your slideshow presentation assets.

The asset-optimizer tool is documented and available here.