Quick Start
Get up and running with Flipswitch in 5 minutes
Quick Start
This guide will help you set up Flipswitch and evaluate your first feature flag.
Prerequisites
- A running Flipswitch server (see Self-Hosting Guide or use our cloud)
- Node.js 18+ or Java 17+
Create a Project and Environment
- Log into the Flipswitch dashboard
- Create a new Project (e.g., "My App")
- Create an Environment (e.g., "Development")
Each environment is isolated - flags can have different states per environment.
Create Your First Flag
- Navigate to Flags in your project
- Click Create Flag
- Enter a key (e.g.,
dark-mode) and select Boolean type - Set the default value to
false - Click Create
Your flag is now created but disabled. Toggle it on to make it evaluate to true.
Generate an API Key
- Go to Settings > API Keys for your environment
- Click Create API Key
- Copy the generated key - you'll need it for SDK initialization
API keys are shown only once. Store them securely.
Test Real-Time Updates
- Run your application
- Go to the Flipswitch dashboard
- Toggle your flag on/off
- Watch your application update in real-time!
The SDK maintains an SSE connection and automatically receives flag changes.
Next Steps
- Learn about Core Concepts (targeting, segments, rollouts)
- Explore the JavaScript SDK or Java SDK in depth
- Set up Targeting Rules for gradual rollouts