Docs Ordnary Web Services Ordnary Halyard
What Ordnary Halyard is
Feature flags and remote config: turn features on per environment, target users with rules and roll out to a percentage, without a deploy.
Concepts
- Project
- One app or service. A project has three environments: Production, Staging and Development.
- Environment
- Each environment has its own state for every flag and its own SDK key, so a flag can be on in Development and off in Production.
- Flag
- A key such as
new-checkoutthat your code asks for. A flag is a boolean, or a string, number or JSON value for remote config, with two or more variations. - Context
- What your app sends about who is asking: a stable
key(a user id) plus any attributes your rules use, such asemail,countryorplan. - SDK key
- A key starting with
ofk_, one per environment. It can only read that environment's flags, so it is safe in a browser or mobile app.
How a flag is evaluated
- If the flag is off in the environment, everyone gets its off variation.
- Otherwise its targeting rules are checked from top to bottom. The first rule whose conditions all match decides what the context gets.
- If no rule matches, the context gets the default: one variation, or a percentage rollout.
Targeting rules
A condition compares one attribute of the context with one or more values. A rule matches when all its conditions do. For an attribute that is a list (such as roles), a condition matches when any item does.
- is one of / is not one of
- Exact match against the values. A context without the attribute counts as not one of them.
- contains, starts with, ends with
- Text matches, ignoring case.
email ends with @yourcompany.comtargets your own team. - is greater than / is less than
- Numeric comparison, for attributes such as
ageorseats.
Percentage rollouts
A rollout splits contexts over variations by weight, for example 10% on and 90% off. Each context is placed by its key, so a user keeps the same answer every time and stays in as you raise the percentage. Send the same key for the same user on every device.
Limits
Projects
Each with Production, Staging and Development.
50per account
Flags
Keys use lowercase letters, digits, ., _ and -.
500per project
Rules
Each with up to 10 conditions of up to 100 values.
50per flag and environment
Variations
Up to 16 KB each.
2 to 20per flag
Add your first flag
Create a project, add a flag and read it from your app in five minutes.