pear-docs/guide/sharing-a-pear-app.md

Sharing a Pear Application

Before releasing a Pear app to the public, it's possible to share it with others.

With Pear there are one single "release" (or "production") version of an app, and then many other named versions. Think of it, the same way that git use branches. Code is put into channels. This way others can test it, and when everything is ready, that branch is pulled into the release channel.

To share apps, stage them using pear stage some-name. This builds a new version of the app and puts them into the some-name channel.

Step 1. Stage the app

Before sharing the app, first stage it into a channel called example (the name can be anything)

$ pear stage example

Step 2. Seed the app

After the app has been staged into the example channel, it now needs to be seeded. This is a way to signal that the app is now shared, so others can download and run it.

🍐 Seeding: chat [ example ]
   ctrl^c to stop & exit

-o-:-
    pear:nykmkrpwgadcd8m9x5khhh43j9izj123eguzqg3ygta7yn1s379o
...
^_^ announced

For now, keep this terminal open. As long as this process is running, your computer will help seed the application.

Step 3. Run the app

In another terminal run:

$ pear run pear:nykmkrpwgadcd8m9x5khhh43j9izj123eguzqg3ygta7yn1s379o

Since the app is now being seeded, any one with the key (pear:nykmk..) can run the same app with pear.

So now try running the same command on another machine or giving the command to a friend to run:

$ pear run pear:nykmkrpwgadcd8m9x5khhh43j9izj123eguzqg3ygta7yn1s379o

Discussion

Marking releases

Previewing prereleases

Reseeding

Lazy loading and sparse replication

Next

The app is shared and others can now run it on their machines. To learn how a more production-ready setup would look like read releasing a Pear App.