@varlock/doppler-plugin

compare this package

Varlock plugin to load secrets from Doppler

  • Types
  • ESM
  • CJS
License
MIT
Deps
0
Install Size
159.3 kB
Vulns
0
Published

Get started

$npm install @varlock/doppler-plugin
$pnpm add @varlock/doppler-plugin
$yarn add @varlock/doppler-plugin
$bun add @varlock/doppler-plugin
$deno add npm:@varlock/doppler-plugin
$vlt install @varlock/doppler-plugin
$vp add @varlock/doppler-plugin

Weekly DownloadsAcross all versions

Compatibility

Node.js
>=22

Versions

2.0.0
latest

Peer Dependency (1)

Keywords

Maintainers

Readme

@varlock/doppler-plugin

Load secrets from Doppler into your Varlock configuration.

Features

  • ✅ Fetch secrets from Doppler projects and configs
  • ✅ Bulk-load secrets with dopplerBulk() via @setValuesBulk
  • ✅ Service token authentication
  • ✅ Efficient caching — single API call shared across all secret lookups
  • ✅ Multiple plugin instances for different projects/configs
  • ✅ Auto-infer secret names from variable names
  • ✅ Helpful error messages with resolution tips

cacheTtl is optional and uses the same duration format as varlock cache() (e.g. "5m", "1h", "1d", or "forever" to cache until manually cleared). Set to false (or an empty string) to disable caching.

Installation

npm install @varlock/doppler-plugin

Or load it directly from your .env.schema file:

# @plugin(@varlock/doppler-plugin)

Setup

1. Create a Service Token in Doppler

Navigate to your project config in the Doppler dashboard → Access → Service Tokens → Generate a token.

2. Configure your .env.schema
# @plugin(@varlock/doppler-plugin)
# @initDoppler(
#   project=my-project,
#   config=dev,
#   serviceToken=$DOPPLER_TOKEN,
#   cacheTtl="1h"
# )
# ---

# @type=dopplerServiceToken @sensitive @internal
DOPPLER_TOKEN=

Usage

Basic secret fetching
# Secret name defaults to the config item key
DATABASE_URL=doppler()
API_KEY=doppler()

# Or explicitly specify the secret name
STRIPE_SECRET=doppler("STRIPE_SECRET_KEY")
Multiple instances
# @initDoppler(id=dev, project=my-app, config=dev, serviceToken=$DEV_DOPPLER_TOKEN)
# @initDoppler(id=prod, project=my-app, config=prd, serviceToken=$PROD_DOPPLER_TOKEN)
# ---

DEV_DATABASE=doppler(dev, "DATABASE_URL")
PROD_DATABASE=doppler(prod, "DATABASE_URL")
Bulk loading secrets
# @plugin(@varlock/doppler-plugin)
# @initDoppler(project=my-project, config=dev, serviceToken=$DOPPLER_TOKEN)
# @setValuesBulk(dopplerBulk())
# ---

# @type=dopplerServiceToken @sensitive @internal
DOPPLER_TOKEN=

DATABASE_URL=
API_KEY=
REDIS_URL=

Resources