[{"data":1,"prerenderedAt":270},["ShallowReactive",2],{"sanity-LevEgKvCUg3Ul3GKyhTsfZIfaGswLQ-qsmdjo9-lWe4":3,"sanity-jQdyChoAE-tfow9UtZsN5lAZzF2eKolSoIjdl53nyxI":49,"shiki-block-v-0-0-0-0-0-1-0-1":269},{"data":4},{"_createdAt":5,"_id":6,"_rev":7,"_type":6,"_updatedAt":8,"acceptAllLink":9,"acceptNecessaryLink":18,"bannerColorSource":23,"bannerDescription":24,"bannerTitle":25,"categories":26,"declineAllLink":27,"managePreferencesLink":31,"modalColorSource":23,"modalTitle":42,"preferencesIconColorSource":23,"provider":43,"savePreferencesLink":44,"thirdPartyEmbedCode":26,"title":48},"2026-11-04T19:10:06Z","cookieSettings","0HimK5Zy5fEFWyyiuf4lm8","2026-11-10T22:53:51Z",{"_type":10,"style":11,"title":16,"type":17},"link",{"_type":12,"stylePreset":13},"link.style",{"_ref":14,"_type":15},"driftwire-link-style-primary","reference","Accept all","button",{"_type":10,"style":19,"title":22,"type":17},{"_type":12,"stylePreset":20},{"_ref":21,"_type":15},"driftwire-link-style-secondary","Necessary only","inherit","We use strictly necessary cookies to keep you signed in, and — only with your consent — analytics to see which docs pages help. No advertising cookies, ever.","Cookies, briefly",null,{"_type":10,"style":28,"title":30,"type":17},{"_type":12,"stylePreset":29},{"_ref":21,"_type":15},"Decline all",{"_type":10,"style":32,"title":41,"type":17},{"_type":12,"icon":33,"iconPosition":39,"stylePreset":40},{"_type":34,"hugeicon":35,"type":38},"icon.config",{"data":36,"name":37},"[[\"path\",{\"d\":\"M15.5 12C15.5 13.933 13.933 15.5 12 15.5C10.067 15.5 8.5 13.933 8.5 12C8.5 10.067 10.067 8.5 12 8.5C13.933 8.5 15.5 10.067 15.5 12Z\",\"stroke\":\"currentColor\",\"strokeWidth\":\"1.5\",\"key\":\"0\"}],[\"path\",{\"d\":\"M21.011 14.0965C21.5329 13.9558 21.7939 13.8854 21.8969 13.7508C22 13.6163 22 13.3998 22 12.9669V11.0332C22 10.6003 22 10.3838 21.8969 10.2493C21.7938 10.1147 21.5329 10.0443 21.011 9.90358C19.0606 9.37759 17.8399 7.33851 18.3433 5.40087C18.4817 4.86799 18.5509 4.60156 18.4848 4.44529C18.4187 4.28902 18.2291 4.18134 17.8497 3.96596L16.125 2.98673C15.7528 2.77539 15.5667 2.66972 15.3997 2.69222C15.2326 2.71472 15.0442 2.90273 14.6672 3.27873C13.208 4.73448 10.7936 4.73442 9.33434 3.27864C8.95743 2.90263 8.76898 2.71463 8.60193 2.69212C8.43489 2.66962 8.24877 2.77529 7.87653 2.98663L6.15184 3.96587C5.77253 4.18123 5.58287 4.28891 5.51678 4.44515C5.45068 4.6014 5.51987 4.86787 5.65825 5.4008C6.16137 7.3385 4.93972 9.37763 2.98902 9.9036C2.46712 10.0443 2.20617 10.1147 2.10308 10.2492C2 10.3838 2 10.6003 2 11.0332V12.9669C2 13.3998 2 13.6163 2.10308 13.7508C2.20615 13.8854 2.46711 13.9558 2.98902 14.0965C4.9394 14.6225 6.16008 16.6616 5.65672 18.5992C5.51829 19.1321 5.44907 19.3985 5.51516 19.5548C5.58126 19.7111 5.77092 19.8188 6.15025 20.0341L7.87495 21.0134C8.24721 21.2247 8.43334 21.3304 8.6004 21.3079C8.76746 21.2854 8.95588 21.0973 9.33271 20.7213C10.7927 19.2644 13.2088 19.2643 14.6689 20.7212C15.0457 21.0973 15.2341 21.2853 15.4012 21.3078C15.5682 21.3303 15.7544 21.2246 16.1266 21.0133L17.8513 20.034C18.2307 19.8187 18.4204 19.711 18.4864 19.5547C18.5525 19.3984 18.4833 19.132 18.3448 18.5991C17.8412 16.6616 19.0609 14.6226 21.011 14.0965Z\",\"stroke\":\"currentColor\",\"strokeLinecap\":\"round\",\"strokeWidth\":\"1.5\",\"key\":\"1\"}]]","Settings02Icon","hugeicon","start",{"_ref":21,"_type":15},"Preferences","Cookie preferences","custom",{"_type":10,"style":45,"title":47,"type":17},{"_type":12,"stylePreset":46},{"_ref":14,"_type":15},"Save preferences","Cookie Settings",{"data":50,"sourceMap":-1},[51],{"_createdAt":52,"_id":53,"_rev":54,"_type":55,"_updatedAt":8,"authorProfile":56,"authorRef":68,"body":70,"categories":188,"excerpt":196,"footer":26,"layout":197,"mainImage":201,"navigation":26,"publishedAt":205,"readTime":107,"relatedPosts":206,"routeOptions":258,"seo":26,"showOnWebsite":260,"slug":263,"tags":264,"title":268},"2026-11-06T17:00:52Z","driftwire-post-percentage-rollouts","0HimK5Zy5fEFWyyiuf4lpW","post",{"avatar":57,"bio":62,"name":63,"role":64,"sameAs":65,"slug":67},{"_type":58,"alt":59,"asset":60},"image","Initials avatar for Avery Lin",{"_ref":61,"_type":15},"image-25375e75ea85051781794390a13c63f315cc700f-256x256-png","Avery builds the edge evaluation layer at Driftwire: the part that answers \"is this flag on?\" four hundred thousand times a second without asking anyone.","Avery Lin","Staff Engineer, Edge",[66],"https:\u002F\u002Fexample.com\u002Fteam\u002Favery-lin","avery-lin",{"_ref":69,"_type":15},"driftwire-author-avery-lin",[71,91,100,110,118,126,134,142,147,154,162,171],{"_key":72,"_type":73,"children":74,"markDefs":89,"style":90},"aee788cdd17b","block",[75,80,85],{"_key":76,"_type":77,"marks":78,"text":79},"2fd1b1527606","span",[],"The naive way to roll a feature out to 25% of users is ",{"_key":81,"_type":77,"marks":82,"text":84},"1ceba649f628",[83],"code","Math.random() \u003C 0.25",{"_key":86,"_type":77,"marks":87,"text":88},"3b513d490aef",[],". It works for exactly one request. On the next, the same user has a three-in-four chance of losing the feature they just saw.",[],"normal",{"_key":92,"_type":73,"children":93,"markDefs":98,"style":99},"2e266e26d1a9",[94],{"_key":95,"_type":77,"marks":96,"text":97},"40e02b1100b0",[],"What a rollout percentage must guarantee",[],"h2",{"_key":101,"_type":73,"children":102,"level":107,"listItem":108,"markDefs":109,"style":90},"59c6afefd10e",[103],{"_key":104,"_type":77,"marks":105,"text":106},"5089bdc739ba",[],"Sticky: the same user gets the same answer on every request.",1,"number",[],{"_key":111,"_type":73,"children":112,"level":107,"listItem":108,"markDefs":117,"style":90},"9952bc35044e",[113],{"_key":114,"_type":77,"marks":115,"text":116},"075c7a40b2c8",[],"Consistent: every server, in every region, agrees without talking to each other.",[],{"_key":119,"_type":73,"children":120,"level":107,"listItem":108,"markDefs":125,"style":90},"9fbb8322c711",[121],{"_key":122,"_type":77,"marks":123,"text":124},"5ad4d0c20387",[],"Monotonic: raising 25% to 50% only ever adds users; nobody who had the feature loses it.",[],{"_key":127,"_type":73,"children":128,"markDefs":133,"style":99},"6bd9d2de1562",[129],{"_key":130,"_type":77,"marks":131,"text":132},"12b3f0d62ade",[],"Hash, then bucket",[],{"_key":135,"_type":73,"children":136,"markDefs":141,"style":90},"0981aefd833f",[137],{"_key":138,"_type":77,"marks":139,"text":140},"ddb902165db3",[],"Driftwire hashes the flag salt and the context key together, takes the result modulo 100, and calls that the user’s bucket. A 25% rollout serves buckets 0–24.",[],{"_key":143,"_type":58,"alt":144,"asset":145,"markDefs":26},"be0fd462d2e5","Diagram: a context key hashed with a salt into bucket 17 of 100; buckets 0 to 24 are lit for a 25% rollout",{"_ref":146,"_type":15},"image-1085db9220e1d5873d3b666e207d74729d08992d-1600x900-png",{"_key":148,"_type":149,"colorSource":83,"markDefs":26,"snippet":150},"ceeef411a4d2","code.block",{"_type":83,"code":151,"filename":152,"language":153},"import { murmur3 } from '.\u002Fhash'\n\nexport function bucket(flagSalt: string, contextKey: string): number {\n    return murmur3(`${flagSalt}:${contextKey}`) % 100\n}\n\nexport function inRollout(percent: number, flagSalt: string, contextKey: string) {\n    return bucket(flagSalt, contextKey) \u003C percent\n}","sdk\u002Frollout.ts","typescript",{"_key":155,"_type":73,"children":156,"markDefs":161,"style":90},"36ecedcdf275",[157],{"_key":158,"_type":77,"marks":159,"text":160},"6b8638248f21",[],"Because buckets never move, raising the percentage is monotonic for free: bucket 17 is in at 25%, at 50% and at 100%.",[],{"_key":163,"_type":73,"children":164,"markDefs":169,"style":170},"1d52961e0d4b",[165],{"_key":166,"_type":77,"marks":167,"text":168},"9eb975fb3159",[],"Why a salt per flag",[],"h3",{"_key":172,"_type":73,"children":173,"markDefs":187,"style":90},"48aac9238a63",[174,178,183],{"_key":175,"_type":77,"marks":176,"text":177},"ef17c48c1ee3",[],"Without one, the same 25% of users would be the guinea pigs for ",{"_key":179,"_type":77,"marks":180,"text":182},"8faf5917b4f7",[181],"strong","every",{"_key":184,"_type":77,"marks":185,"text":186},"8d9b88884427",[]," experiment. Salting by flag reshuffles who goes first each time.",[],[189],{"_createdAt":52,"_id":190,"_rev":191,"_type":192,"_updatedAt":193,"slug":194,"title":195},"driftwire-category-engineering","W5BzlLjnYUuDrmlopXouBu","category","2026-11-10T22:53:47Z","engineering","Engineering","A 25% rollout is not \"one request in four\". It is a stable answer to \"is this user in?\", identical on every server, that never flips a user back out. That is a hashing problem.",{"_type":198,"layout":199,"pageDesign":200},"post.layout.options","default","design1",{"_type":58,"alt":202,"asset":203},"Engineering cover: Percentage rollouts are a hashing problem",{"_ref":204,"_type":15},"image-4b4179c3d9320c0f9bf734ebd4c1860ecdabdd2a-1600x900-jpg","2026-09-08T09:00:00.000Z",[207,223,243],{"_id":208,"authorProfile":209,"categories":212,"excerpt":214,"mainImage":215,"publishedAt":219,"readTime":220,"slug":221,"title":222},"driftwire-post-edge-propagation",{"avatar":210,"name":63,"role":64,"slug":67},{"_type":58,"alt":59,"asset":211},{"_ref":61,"_type":15},[213],{"slug":194,"title":195},"A kill switch that takes a minute to arrive is a status page with extra steps. How our control plane fans a single write out to 312 edge nodes, and where the 38 ms actually goes.",{"_type":58,"alt":216,"asset":217},"Engineering cover: How we push a kill switch to 312 edge nodes in 38 ms",{"_ref":218,"_type":15},"image-75833b45f7bd6ef1e0d8f5900a4006e107fdb8bd-1600x900-jpg","2026-10-06T09:00:00.000Z",2,"edge-propagation","How we push a kill switch to 312 edge nodes in 38 ms",{"_id":224,"authorProfile":225,"categories":233,"excerpt":235,"mainImage":236,"publishedAt":240,"readTime":107,"slug":241,"title":242},"driftwire-post-testing-combinations",{"avatar":226,"name":230,"role":231,"slug":232},{"_type":58,"alt":227,"asset":228},"Initials avatar for Jordan Hale",{"_ref":229,"_type":15},"image-097a0f6135da5d3dedfc9d8fe79bba96e1550621-256x256-png","Jordan Hale","Co-founder & CTO","jordan-hale",[234],{"slug":194,"title":195},"Ten boolean flags make 1,024 combinations, and you will not test them all. You do not need to. Test the defaults, the targets, and the pairs that touch the same code.",{"_type":58,"alt":237,"asset":238},"Engineering cover: You cannot test every flag combination. Test these instead",{"_ref":239,"_type":15},"image-a6198bda12704ab24d51cd2c562ac7f6ab1ae15c-1600x900-jpg","2026-07-14T09:00:00.000Z","testing-combinations","You cannot test every flag combination. Test these instead",{"_id":244,"authorProfile":245,"categories":248,"excerpt":250,"mainImage":251,"publishedAt":255,"readTime":107,"slug":256,"title":257},"driftwire-post-edge-vs-server",{"avatar":246,"name":63,"role":64,"slug":67},{"_type":58,"alt":59,"asset":247},{"_ref":61,"_type":15},[249],{"slug":194,"title":195},"Evaluating flags at the edge is fast. Evaluating them on your server is simple. Which one you want depends on numbers you can measure in an afternoon.",{"_type":58,"alt":252,"asset":253},"Engineering cover: Edge or server evaluation? Measure before you choose",{"_ref":254,"_type":15},"image-335586df211ad6b1e711562eccf1cf16e8090a11-1600x900-jpg","2026-06-02T09:00:00.000Z","edge-vs-server","Edge or server evaluation? Measure before you choose",{"_type":259,"includeInSitemap":260,"slug":261},"page.routing.options",true,{"_type":262,"current":263},"slug","percentage-rollouts",[265,266,267],"Rollouts","Hashing","SDK","Percentage rollouts are a hashing problem","\u003Cpre class=\"shiki shiki-themes github-light github-dark nuxion-code__pre\" style=\"--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#6A737D;--shiki-dark:#6A737D\">\u002F\u002F What an edge node receives: a diff against the version it holds.\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#D73A49;--shiki-dark:#F97583\">interface\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#6F42C1;--shiki-dark:#B392F0\"> RulesetDiff\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#24292E;--shiki-dark:#E1E4E8\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#E36209;--shiki-dark:#FFAB70\">    version\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#D73A49;--shiki-dark:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#005CC5;--shiki-dark:#79B8FF\"> number\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#E36209;--shiki-dark:#FFAB70\">    previous\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#D73A49;--shiki-dark:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#005CC5;--shiki-dark:#79B8FF\"> number\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#E36209;--shiki-dark:#FFAB70\">    changed\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#D73A49;--shiki-dark:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#6F42C1;--shiki-dark:#B392F0\"> Record\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#24292E;--shiki-dark:#E1E4E8\">&#x3C;\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#005CC5;--shiki-dark:#79B8FF\">string\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#24292E;--shiki-dark:#E1E4E8\">, \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#6F42C1;--shiki-dark:#B392F0\">FlagRules\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#24292E;--shiki-dark:#E1E4E8\">>\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#E36209;--shiki-dark:#FFAB70\">    removed\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#D73A49;--shiki-dark:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#005CC5;--shiki-dark:#79B8FF\"> string\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#24292E;--shiki-dark:#E1E4E8\">[]\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#24292E;--shiki-dark:#E1E4E8\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#D73A49;--shiki-dark:#F97583\">function\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#6F42C1;--shiki-dark:#B392F0\"> apply\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#24292E;--shiki-dark:#E1E4E8\">(\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#E36209;--shiki-dark:#FFAB70\">diff\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#D73A49;--shiki-dark:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#6F42C1;--shiki-dark:#B392F0\"> RulesetDiff\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#24292E;--shiki-dark:#E1E4E8\">) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line nuxion-code__line--marked\">\u003Cspan style=\"--shiki-light:#D73A49;--shiki-dark:#F97583\">    if\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#24292E;--shiki-dark:#E1E4E8\"> (diff.previous \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#D73A49;--shiki-dark:#F97583\">!==\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#24292E;--shiki-dark:#E1E4E8\"> store.version) \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#D73A49;--shiki-dark:#F97583\">return\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#6F42C1;--shiki-dark:#B392F0\"> resync\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#24292E;--shiki-dark:#E1E4E8\">() \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#6A737D;--shiki-dark:#6A737D\">\u002F\u002F missed one: fetch a snapshot\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#24292E;--shiki-dark:#E1E4E8\">    store.\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#6F42C1;--shiki-dark:#B392F0\">merge\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#24292E;--shiki-dark:#E1E4E8\">(diff.changed, diff.removed)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#24292E;--shiki-dark:#E1E4E8\">    store.version \u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#D73A49;--shiki-dark:#F97583\">=\u003C\u002Fspan>\u003Cspan style=\"--shiki-light:#24292E;--shiki-dark:#E1E4E8\"> diff.version\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"--shiki-light:#24292E;--shiki-dark:#E1E4E8\">}\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>",1794954844850]