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