Master Your Feature Flags
Complete guide to integrating, managing, and scaling feature flags with Easy Flags. From first setup to advanced targeting strategies.
Getting Started
Welcome to Easy Flags! This guide will help you set up feature flags in your application. Feature flags allow you to control which features are visible to your users, enabling safe rollouts, A/B testing, and gradual deployments.
Organize your projects and teams into dedicated workspaces.
Define features and targeting rules for each environment.
Integrate our light-weight API into your codebase in seconds.
Understanding the Hierarchy
Spaces
Top-level organizations or projects. Think of a Space as a product team or a standalone platform.
Environments
Deployment stages like Production, Staging, or Development. Flags are configured independently per environment.
Features
Individual feature flags. These are the toggles you reference in your code to control behavior.
Space: "Acme Corp" ├─ Environment: Production │ ├─ Feature: new_dashboard (100%) │ └─ Feature: dark_mode (50%) ├─ Environment: Staging │ ├─ Feature: new_dashboard (100%) │ └─ Feature: dark_mode (100%)
Managing Spaces
Spaces are your top-level containers. Everything in Easy Flags exists within a Space. Usually, you'll have one Space per project or one per team in a large organization.
Workspace Setup
- 1
Navigate to the Spaces section in your dashboard.
- 2
Click "Create New Space" and give it a descriptive name.
- 3
Configure your environments (Dev, Staging, Prod) within the space settings.
Pro Tip
Use meaningful names for your spaces like Mobile App or Core API instead of vague names like Project 1.
Managing Features
Features are the individual items you want to control. Each feature can have different values across your environments.
Feature Types
- Boolean On / Off
- String Config Text
- JSON Complex Context
Best Practices
- ✓ Use kebab-case for keys (new-search-bar)
- ✓ Set deadlines for feature flag removals
- ✓ Audit flags every 2 weeks
Environments
Isolate your feature flags across different stages of your delivery pipeline. Configure variations independently for each environment.
Environments - Production
The live environment where your end-users interact with features. High stability and strict rollout rules.
Staging
A pre-production environment for final testing and QA validation before going live.
Development
Where engineering teams build and test new features. Rapid iteration and experimental values.
Targeting & Rollout
Control exactly who sees what. Use advanced rules to target users by attributes or roll out features gradually to a percentage of your audience.
Percentage Rollouts
Incrementally increase the user base for a feature from 0% to 100% to ensure system stability and monitor metrics.
User Attributes
Target by email domain, subscription tier, geographic location, or any custom metadata you send to the API.
API Integration
Integrate Easy Flags effortlessly into any stack. Our RESTful API is fast, secure, and globally distributed.
const evaluateFlag = async (key, userId) => { const response = await fetch(`/api/v1/evaluate/${key}`, { headers: { 'X-API-Key': 'YOUR_SECRET_KEY', 'X-User-ID': userId } }); return response.json(); };
Team & Roles
Collaborate securely with your entire team. Assign specific permissions to control who can view, create, or publish feature flags.
| Role | Permissions |
|---|---|
| Owner | Full access to billing, team management, and all spaces. |
| Admin | Can manage environments and flags across assigned spaces. |
| Viewer | Read-only access to flag configurations and evaluation history. |