PermitPlane Docs

Add licensing to a Flutter app in five minutes

1. What you need

2. Create a sandbox product

Sign in, verify your email and turn on MFA. Create your business, add a sandbox product and publish its policy: how many installations a licence allows, the trial length (14 days by default), and the offline days. Optionally describe what each licence unlocks with entitlements:

{
  "document.export": {"type": "boolean", "value": true},
  "workers": {"type": "limit", "value": 3}
}

3. Issue a test licence

Use a reference such as customer-001, choose the paid-through date and copy the licence key. Your customer never needs a PermitPlane account; you deliver the key through your own checkout or support flow.

4. Add the SDK and configuration

Download the product's public configuration from its Setup page and ship it as an app asset. It holds no secrets. The SDK packages are published on pub.dev as permitplane_client (the protocol client) and permitplane_flutter (the Windows and Android adapters). Add them to your app:

flutter pub add permitplane_client permitplane_flutter

5. Activate and check a feature

final licensing = LicenseClient(
  config: productConfig,
  platform: WindowsInstallationPlatform(storageName: 'my-app'),
  transport: HttpsTransport(productConfig['base_url']),
);
await licensing.initialize();
await licensing.activateWithKey(enteredKey, deviceName: 'My application');
if (licensing.hasFeature('document.export')) { exportDocument(); }
final workers = licensing.getLimit('workers');

6. Try the honest-customer path

Activate, go offline and restart the app: the cached signed access keeps working. Reconnect and refresh, then release the installation to free the slot for another device.

Next

Account-based trials, purchase connectors, webhooks and the full API reference are in the documentation for signed-in vendors. Sign in.