Skip to content

Google's Web Starter Kit is a terrific. This is a quick start dev environment with slightly different opinions. It strips material design and service worker. Then adds deploy to github pages, auto reload on js change, and plumber to stop gulp reload from crashing.

License

Notifications You must be signed in to change notification settings

joshmangum/web-starter-kit

 
 

Repository files navigation

Changes from Google Web Starter Kit

Removed material design, service worker (still buggy), and detailed documentation.

Added support for Github Pages deployment, gulp plumber to stop gulp reload from crashing, and auto reload when js files change.

Getting started

Clone repository to new location, or use the zip file.

Type $ npm install in directory.

Deploy to Github Pages

Make git repository and add to Github

Visit https://github.com/new and add repository name [repo].

Create the git repository and set it's remote to the new github repo.

git init
git add .
git commit -m "First commit"
git remote add origin https://github.com/[user]/[repo].git
git remote -v
git push origin master

Then type: $ gulp deploy to push to Github Pages.

Normal development cycle guide

  • Run $ gulp serve to write, debug, and test feature locally.
  • Use gulp clean first to remove dist directory. Then commit code normally:
gulp clean
git add .
git commit -m "a change message"   
git push origin master
  • Run $ gulp deploy to build dist directory and push it to gh-pages branch.

Original docs

View original documentation for more details.

Github Pages deployment setup

Historical notes about changes needed from .6 version of google-web-starter-kit to make Github Pages deployment work.

Add gulp-subtree and vinyl-paths

npm install --save-dev gulp-subtree
npm install --save-dev vinyl-paths

Remove dist from .gitignore and delete contents

New .gitignore:

  node_modules
+#dist
- dist
 .tmp
 app.yaml

Delete dist directory contents

rm -rf dist/*

Delete existing gh-pages branch

There's an existing branch in the tree. $ git push origin --delete gh-pages

See commit history for changes to gulp file

Added deploy task

Usage

  1. Run $ gulp deploy.
  2. Visit http://[your-username].github.io/[repo-name].

References

About

Google's Web Starter Kit is a terrific. This is a quick start dev environment with slightly different opinions. It strips material design and service worker. Then adds deploy to github pages, auto reload on js change, and plumber to stop gulp reload from crashing.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 79.1%
  • HTML 18.3%
  • CSS 2.6%