How it works

A clear path from stored secret to application.

Organize secrets around your projects, keep environments distinct, and use a language-specific SDK to retrieve the values your application needs.

Four steps

Set up your project.

A simple workflow that keeps the moving parts understandable.

Create a project

Give your application a dedicated project in the Top Secrete console. Use a name that maps clearly to the service you are building.

Organize environments

Separate values for development, staging, and production. Keep each environment's configuration clearly identified.

Add your secrets

Create named values such as DATABASE_URL, PAYMENT_API_KEY, or SESSION_SECRET in the appropriate environment.

Retrieve through the SDK

Initialize the SDK with your project and environment, then request the secret by its name from your application code.

In your code

Request the value by name.

The SDK gives your application a consistent interface for requesting a named secret. Choose a language tab to view an example.

Read the SDK guide

retrieve-secret

import { TopSecrete } from "@topsecrete/sdk";

const secrets = new TopSecrete({
  project: "edgipay-api",
  environment: "production",
});

const databaseUrl = await secrets.get("DATABASE_URL");

Illustrative SDK usage · see the documentation for package setup.

Designed around your app

A few useful concepts.

Projects

Group the secrets used by an application or service.

Environments

Keep development, staging, and production values separate.

Named secrets

Retrieve a value using a stable name such as DATABASE_URL.