Quick Start

This guide will get you up and running with Tier.
If you run into challenges at any point, come ask for help in the Tier community Slack.

Step 1 - Install Tier

Tier can either be installed as a static binary, or run from source with go.

Homebrew (macOS)

brew install tierrun/tap/tier

Binary (macOS, linux, Windows)

Binaries for major architectures can be found at here.

Go (most operating systems and architectures)

If go1.19 or later is installed, running or installing tier like:
go run[email protected]
go install[email protected]

Step 2: Connect to Stripe

Run tier connect to grant the Tier CLI access to your Stripe account.
By default, Tier uses a restricted key with very limited permissions. You can use Tier in your Stripe test mode environment until you're ready to commit.

Step 3: Define a Pricing Model

This file is the configuration that Tier uses to define your plans and features.
You can define a pricing model by writing a pricing.json file, or by using the Model Builder.
Make sure to see the Recipes for examples of pricing.json files reflecting common SaaS pricing models.

Step 4: Push the Pricing Model

If you've created the pricing model in the Model Builder, you can push it by copying the URL and running:
tier push <url>
You can also push a pricing.json file by running:
tier push pricing.json
If there are any mistakes in the pricing.json file, this will tell you about them. If everything checks out, then Tier will create all the appropriate Stripe Product and Price objects, tagged and named deterministically so that they can be referenced later.
Links to the Stripe dashboard are printed whenever you push, so that you can see what it created.

Step 5: Integrate with Your App

Use the tier commands and SDK to create customer subscriptions, report feature usage, and track usage limits.
See Integration for more information.
Last modified 1mo ago