Dashboard Walkthrough

A quick tour of the Flipswitch dashboard and how to accomplish common tasks.

Navigation

The sidebar shows:

Organization Name
├── Projects
│   ├── Project A
│   └── Project B
└── Organization Settings

Click a project to manage its flags, environments, and segments.

Projects View

The projects list shows all projects you have access to:

• Name and key
• Environment count
• Flag count
• Last modified

Click Create Project to add a new project. Enter a name and key (kebab-case).

Project Dashboard

Inside a project, you see:

Flags Tab

All flags in the project. Each flag shows:

• Key and name
• Type (boolean, string, number, object)
• Status per environment (enabled/disabled indicators)

Creating a flag:

1. Click Create Flag
2. Enter the key (e.g., new-checkout)
3. Select the type
4. Add variants
5. Set the default variant
6. Click Create

The flag is created disabled in all environments.

Environments Tab

All environments in the project (e.g., development, staging, production). Select an environment to view its settings and API key.

Each environment has:

• Name and description
• Color indicator
• API key (auto-generated, single key per environment)

Creating an environment:

1. Click Create Environment
2. Enter a name (e.g., "Staging")
3. Add an optional description
4. Select a color
5. Click Create

An API key is automatically generated when you create an environment.

Segments Tab

Reusable user groups for targeting. Each segment shows:

• Key and name
• Conditions summary
• Usage count (how many flags reference it)

Creating a segment:

1. Click Create Segment
2. Enter a key (e.g., beta-users)
3. Add conditions (e.g., email ENDS_WITH "@beta.company.com")
4. Click Create

Flag Detail View

Click a flag to see its configuration:

Overview

• Flag key and name
• Type and variants
• Description

Environment Rules

Select an environment to configure its rules:

Enabling/Disabling:

Toggle the enabled switch. When disabled, the flag returns the default variant.

Default Variant:

Select which variant to return when no rules match.

Targeting Rules:

Add rules that match context attributes:

1. Click Add Rule
2. Set conditions (e.g., email ENDS_WITH "@company.com")
3. Select the variant to return
4. Set priority (lower number = higher priority)
5. Save

Rules are evaluated in priority order. First match wins.

Gradual Rollout:

Set percentage distribution across variants:

1. Enable gradual rollout
2. Set percentages for each variant
3. Ensure they sum to 100%
4. Save

API Keys

Each environment has exactly one API key, auto-generated when the environment is created. View and manage keys in the Environments tab by selecting an environment.

Viewing your key:

1. Select an environment in the Environments tab
2. Find the API Key section
3. Click the eye icon to reveal the full token
4. Click the copy icon to copy it

Rotating a key:

If a key is compromised or you need a fresh credential:

1. Click Rotate Key
2. Copy the new key immediately
3. Update your applications with the new key
4. The old key remains valid for 24 hours (grace period)

Aborting rotation:

Changed your mind? While rotation is in progress:

1. Click Abort Rotation
2. The new key is deleted
3. The old key is restored as the primary key

Completing rotation early:

Don't want to wait 24 hours? Click Revoke Immediately to invalidate the old key right away.

Audit Log

Navigate to Project > Audit Log to see all changes:

• Who made the change
• What changed
• When it happened

Use filters to narrow down:

• Date range
• User
• Flag
• Action type

Organization Settings

Click Organization Settings in the sidebar:

Members

View and manage organization members:

• Invite new users
• View pending invitations
• Remove members

Groups

Manage permission groups:

• Create groups
• Add permissions
• Add/remove members

Keyboard Shortcuts

Common Tasks

Enable a flag for internal users only

1. Create segment internal-users with condition email ENDS_WITH "@yourcompany.com"
2. Open the flag
3. Select the production environment
4. Add rule: IF user IN SEGMENT "internal-users" THEN enabled
5. Save

Set up a 10% rollout

1. Open the flag
2. Select the environment
3. Enable the flag
4. Add gradual rollout: 10% -> enabled, 90% -> disabled
5. Save

Roll back a feature

1. Open the flag
2. Select the environment
3. Toggle the enabled switch to off
4. Save

The flag immediately returns the default variant for all users.