@featurepeek/peek

peek.js

@featurepeek/peek is an npm package that lets you deploy your static frontends to FeaturePeek. It's a node.js wrapper around our homebrew-distributed Go package, making it easy to use in the JavaScript ecosystem.

FeaturePeek creates supercharged deployment previews of your frontend that you can share (with friends, coworkers, Twitter followers — anyone!) to quickly get feedback on your implementation in progress. A drawer overlay is added on top of your site that makes it easy for your reviewers to take screenshots with annotations, capture screen recordings, leave comments, create tickets on popular bug-tracking platforms, and more. You get this functionality just by deploying to FeaturePeek — no dependencies or code changes needed.

To get started, install from npm:

yarn add @featurepeek/peek --dev

or

npm install @featurepeek/peek --save-dev

Looking to install globally? We recommend installing with homebrew rather than npm install -g.

Setup

1. yarn featurepeek login – this will create a FeaturePeek account for you if you don't have one already, and authenticate you in your CLI.
2. yarn featurepeek init – this generates a configuration file that the CLI uses.

Usage

The typical usage flow looks like this:

1. Commit and push your changes. You can be on any branch.
2. Run your build command. Since you just committed and pushed your changes, your deployment will be tied to a hash in your git history, making it easy to see the source that generated your build.
3. Run yarn featurepeek. Your deployment preview will be ready after a few moments.

That's all there is to it! After your assets are packaged and uploaded, a shareable URL will be returned.

You can send this URL to anyone to get their feedback on your implementation. They won't need a FeaturePeek account to view your deployment, but they will need to create one to leave comments or file issues in the FeaturePeek drawer overlay. If you'd like your URLs to be private, subscribe to FeaturePeek Teams.

Upgrading

We periodically release new versions of this tool. To upgrade to the latest version available, run yarn upgrade @featurepeek/peek.

Issues, feedback, and feature requests

Run into trouble? Have a feature request? Want to contribute? Leave any questions or ideas you may have on the GitHub Issues page.

FeaturePeek Teams

FeaturePeek Indie is great for sharing single commits on personal projects. For company projects, you'll want to use FeaturePeek Teams:

• Enables private deployments that only your team can access.
• Runs in your Continuous Integration pipeline for automatic deployment previews on every pull request.
• Works with frontends containerized in Docker in addition to static frontends.