Quick Start

Get up and running with Flagstack in under 5 minutes.

1. Create an Account

Sign up for Flagstack and create your organization. You'll get access to the dashboard immediately.

2. Create an API Token

Navigate to your organization's API Tokens page and create a new token. Keep this token safe — you'll need it to configure your app.

3. Add the Gem

Add the Flagstack gem to your Gemfile:

gem "flagstack"
gem "flipper"
gem "flipper-active_record" # recommended

Then run:

$ bundle install
$ rails generate flagstack:install

4. Configure Your Token

Set the environment variable with your API token. Flagstack auto-configures when this is set:

$ export FLAGSTACK_TOKEN=your_token_here

Or configure explicitly in the generated initializer:

Flagstack.configure do |config|
  config.token = ENV["FLAGSTACK_TOKEN"]
end

5. Create Your First Flag

In the Flagstack dashboard, click New Feature and create a flag called new_feature.

6. Check the Flag

Now you can check the flag anywhere in your Rails app:

if Flagstack.enabled?(:new_feature)
  # New feature code
end

# Or with a specific user
if Flagstack.enabled?(:new_feature, current_user)
  # User-specific feature
end