@helpscout/kiwi

🥝 Kiwi

Seamless syncing for Design Github Wikis

Kiwi was specifically designed to handle automatic Wiki deploys for Help Scout's Design System.

Table of Contents

• Setup
  • CI Variables
  • Git User
• Usage
• Examples
  • Netlify

Setup

CI Variables

Add the following global environment variables to your build/CI tool:

GITHUB_USER = bob_belcher_2019
GITHUB_REPO = baby-you-can-chive-my-car-burger
TOKEN = CV9$Xc]6iZVJRJiE*uV6MooXg
LOCAL_DIR = burger-project

GITHUB_USER

The Github user name of your repository.

GITHUB_REPO

The Github repository name.

TOKEN

Your super secret Github personal access token

LOCAL_DIR

The directory of your (CI) local directory.

Git User

Since Kiwi needs to push to a Github wiki, ensure that your environment's Git has been set up with a username and email:

git config --global user.email "[e-mail]"
git config --global user.name "bob_belcher_2019"

Usage

Once you have the above ☝️ set up (it's very important!), all you have to do is run:

npx @helpscout/kiwi

Examples

Netlify

For Netlify, you can create a simple netlify.sh file (or call it whatever you'd like 😍)

# Configures the Git name and email for the commits
git config --global user.email "[e-mail]"
git config --global user.name "bob_belcher_2019"

# Set the environment variables
export GITHUB_USER=bob_belcher_2019
export GITHUB_REPO=baby-you-can-chive-my-car-burger
export TOKEN=CV9$Xc]6iZVJRJiE*uV6MooXg
export LOCAL_DIR=repo

# Runs Kiwi
npx @helpscout/kiwi

# Creates an empty page for Netlify to deploy
mkdir public
touch public/index.html

With that, you can set up the following:

• Build command: sh netlify.sh
• Publish directory: public