Quickstart

Install the CLI

npm install --save-dev @guapocado/cli

Create a Billing Config

npx guap init

This creates a billing config in your project. Guapocado is config-first, so the config file is the source of truth for products, plans, entitlements, and meters.

Log In

npx guap login --sandbox

Local platform development can point the CLI at a local dashboard:

npx guap login --sandbox --url http://localhost:4777

Preview and Push

npx guap plan --sandbox
npx guap push --sandbox

Check an Entitlement

import { createGuapocadoClient } from "@guapocado/sdk";

const guap = createGuapocadoClient({
  apiKey: process.env.GUAPOCADO_API_KEY!,
  customerId: "org_123",
});

const allowed = await guap.has("advanced-analytics");