GitHub Pages
What Are And How to use gh-pages

Kent C. Dodds
@kentcdodds
Marvel Random
Building a sweet library with the Marvel API

Write the Library

Add A Build

Make a Demo

Enter gh-pages

What are GH-Pages
"Websites for you and your projects. Hosted directly from your GitHub repository. Just edit, push, and your changes are live." - pages.github.com

Jekyll
"Jekyll is a blog-aware, static site generator in Ruby" - https://github.com/jekyll/jekyll

How To Use gh-pages
- Users / Organizations: It's all about the repo name
- Projects: It's all about the gh-pages branch
User/Org PageS
1. Create a repo called <username>.github.io
2. Push code master branch
3. Boom! Static files hosted!
http://<username>.github.io

Project Pages
1. Create a repo called <whatever>
2. Push code to gh-pages branch
3. Boom! Static files hosted!
http://<username>.github.io/<whatever>
Create gh-pages Branch

Add GH-Pages to Build

Custom Domains
1. Create a file (in the repo root) called "CNAME"
2. Add one line that's your domain
3. Setup your DNS to forward properly
That's it!
Working With Backends
1. Firebase
2. Custom

That's it!
Questions?
Thanks.
Kent C. Dodds
@kentcdodds
gh-pages
By Kent C. Dodds
gh-pages
What are and how to use github pages
- 7,989