Fruitful Docs
Get started

Install the CLI and sign in

Get a checkout, run the fruitful CLI, and authorize it against the registry.

Feed Packages live in the Fruitful repository under feed-packages/, and the fruitful CLI runs from that checkout. This page gets you to a working CLI and a signed-in session.

Check out the repository

git clone https://github.com/fruitful-code/fruitful.git
cd fruitful
fnm use --install-if-missing   # Node version pinned in .nvmrc
yarn                           # Yarn 4 via Corepack

Run the CLI

Every command runs through the repository root as yarn fruitful <group> <command>. Check it works:

yarn fruitful --help

You should see the command list. The full list with a summary of each is on the CLI reference.

Sign in

Registry commands (registry status, publish-first-party, approve, promote) need a credential. Everything else in this tutorial runs offline against committed evidence, so you can skip this until Publish it to the registry.

yarn fruitful auth login
yarn fruitful auth status

auth login opens a browser for a scoped device grant and stores the credential in the operating system keychain. It never asks for a password on the command line.

What you need for live capture

Validation and preview work from the fixtures a package commits. Capturing a real page (authoring capture) drives a local browser and needs a desktop machine; it will not run in CI. The tutorial points out which steps are which.

Next: Your first package.

On this page