Web Admin

Accessing the Web Admin

There are two ways to access the Redshift web admin:

Hosted Version

Visit redshiftapp.com/admin to use the hosted web admin. This connects directly to Nostr relays from your browser - no data passes through our servers.

Local Version

Run the web admin locally using the CLI:

redshift serve --open

This starts a local server at http://localhost:3000 with the same functionality.

Connecting

When you first open the web admin, you'll need to connect with your Nostr identity:

1. Click the "Connect" button in the top right
2. Choose your authentication method:
   • Browser Extension - Uses Alby, nos2x, or similar (recommended)
   • Private Key - Enter your nsec directly
   • Bunker - Connect via NIP-46 remote signer
3. Approve the connection if prompted by your extension

Dashboard

After connecting, you'll see your dashboard showing all your projects. From here you can:

• View all projects at a glance
• See environment count per project
• Create new projects
• Access global search (⌘K / Ctrl+K)

Managing Projects

Creating a Project

1. Click "New Project" on the dashboard
2. Enter a project name (e.g., "my-api", "frontend")
3. Click "Create"

New projects automatically include a "Development" environment. You can add more environments like staging and production.

Project Settings

Click on a project to access its settings:

• Rename - Change the project name
• Add Environment - Create new environments
• Delete - Remove the project and all its secrets

Managing Environments

Environments let you separate secrets for different stages (dev, staging, prod):

Adding an Environment

1. Open a project
2. Click "Add Environment"
3. Enter a slug (e.g., "staging") and display name (e.g., "Staging")
4. Click "Add"

Switching Environments

Use the environment tabs at the top of the project page to switch between environments. Each environment has its own set of secrets.

Managing Secrets

Adding Secrets

1. Open a project and select an environment
2. Click "Add Secret" or use the inline form
3. Enter the key name (automatically uppercased)
4. Enter the value
5. Click "Save" or press Enter

Editing Secrets

Click on any secret value to edit it inline. Press Enter to save or Escape to cancel.

Deleting Secrets

Click the trash icon next to a secret to delete it. This action requires confirmation.

Bulk Operations

Use the Import/Export buttons to work with multiple secrets:

• Import - Paste a .env file or JSON to add multiple secrets at once
• Export - Download secrets as .env or JSON format

Search

Press ⌘K (Mac) or Ctrl+K (Windows/Linux) to open global search:

• Search across all projects and environments
• Find secrets by key name
• Quick navigation to any project or environment

Relay Status

The relay indicator in the header shows your connection status:

• ● Green - Connected to relays
• ● Yellow - Connecting...
• ● Red - Connection error

Click the indicator to see details about which relays are connected.

Security Notes

• Client-side encryption - All secrets are encrypted in your browser before being sent to relays
• No server storage - The hosted version doesn't store any of your data
• Session-based - For nsec auth, your key is encrypted and only stored for the browser session
• Disconnect when done - Click your profile and "Disconnect" when finished

Keyboard Shortcuts