Need help with gh-pages-deploy?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

meandavejustice
212 Stars 22 Forks MIT License 41 Commits 12 Opened issues

Description

publish to gh-pages from package.json

Services available

!
?

Need anything else?

Contributors list

# 60,525
Firefox
Shell
React
PHP
6 commits
# 124,480
GraphQL
webpack...
Electro...
Angular
2 commits
# 46,771
TypeScr...
tensorf...
Amazon ...
nvidia-...
1 commit
# 18,598
CSS
Sass
Firefox
github-...
1 commit
# 3,886
ESLint
texture...
Electro...
TypeScr...
1 commit
# 56,011
HTML
casperj...
Firefox
phantom...
1 commit

GH-pages-deploy

NPM

Deploy straight to github pages with one simple command.

Usage

# install it from npm and symlink it into your PATH
npm install gh-pages-deploy -g

now run it!

gh-pages-deploy

You can also use

npm run
to package it with your app without installing it globally.

First add this to your scripts section of

package.json
:
  "scripts": {
    "deploy": "gh-pages-deploy",
    "clean-source": "rimraf README.md src webroot package.json"
  },

And then install

gh-pages-deploy
as a devDependency:
npm install gh-pages-deploy --save-dev

And now you can run

npm run deploy
to run the
gh-pages-deploy
installed in the local
node_modules
folder (even if you have never done
npm install gh-pages-deploy -g
).

You can also provide a custom commit message via command line argument:

  "scripts": {
    "deploy": "gh-pages-deploy -- 'A custom commit message'",
  },

Options

To configure

gh-pages-deploy
all you need to do is specify a couple of things in your
package.json
(all of which are optional)
  "gh-pages-deploy": {
    "staticpath": "dist",
    "cname": "nope.org",
    "prep": [
      "build-sass",
      "optimize-img"
    ],
    "commit": "a custom commit message",
    "post": [
      "clean-source"
    ],
    "noprompt": false
  },

  • "staticpath" path to your files to be copied over to the root directory
  • "cname" content for CNAME file
  • "prep" an array of script names to run before pushing to github, this can be any script that you have declared in your "scripts" object in your
    package.json
    .
  • "commit" a custom commit message to be used when committing to git
  • "post" an array of script names to run after "prep", but before add/commit/push
  • "noprompt" if this is set to true, the prompt will be bypassed and you will never need to confirm the commands before deploying.

About

This repo uses

gh-pages-deploy
. Checkout the gh-pages branch and the result at http://davejustice.com/gh-pages-deploy/.

This was inspired after a conversation with max ogden regarding the setup of the Code For Portland Jekyll Pages. Inspired by the leveldb.org repository, I wanted an easier way for people to generate static pages and deploy to github without being tied to just jekyll.

LICENSE

MIT

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.