PermitPlane Docs

Core concepts

Products and environments

A product is one app you sell. Each product has a sandbox environment for testing and a production environment for real customers. They are separate: nothing in the sandbox affects production.

Policies

A policy sets the rules for new licences of a product:

A new policy version applies to new licences only; existing licences keep the rules they were issued under.

Licences and licence keys

A licence is the right to use a product, with a paid-through date. A licence key is a secret string you give your customer so they can activate the licence in your app. Treat keys like passwords: keep them out of URLs and logs.

Installations

Activating a licence on a device creates an installation, which uses one slot of the installation limit. Releasing the installation frees the slot, for example when a customer moves to a new computer.

Signed offline grants

When an app activates or refreshes, PermitPlane returns a signed grant that the app verifies on the device. Offline access ends at the earlier of the policy's offline cap and the licence's paid-through date. If the device clock looks wrong, the app must check online again; it never silently extends access.

Entitlements

Entitlements say what a licence unlocks. They are boolean features (on or off), numeric limits, or explicitly unlimited, and your app reads them from the verified grant.