Stages

• development
• staging
• production

​

Why stages matter

• DATABASE_URL in development
• DATABASE_URL in production

​

How the CLI targets a stage

1. --stage
2. barekey.json

barekey env list --stage production
barekey env pull --stage staging --out .env.staging

​

How the SDK targets a stage

import { BarekeyClient } from "@barekey/sdk/server";

const barekey = new BarekeyClient({
  organization: "acme",
  project: "api",
  environment: "production",
});

{
  "organization": "acme",
  "project": "api",
  "environment": "production"
}

​

Good stage habits

• keep development, staging, and production values separate
• commit barekey.json so teammates target the same default stage
• use --stage explicitly in scripts when the target matters
• use production tokens and production stages carefully