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 tier.run/cmd/tier@latest

or

go install tier.run/cmd/tier@latest

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: Write a pricing.json File

This file is the configuration that Tier uses to define your plans and features.

Make sure to see the Recipes for examples of pricing.json files reflecting common SaaS pricing models.

Step 4: Run tier push pricing.json

If you've made 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.