Read feature flags before the first paint

How to do it

Follow deploy is not release for how flags work. Evaluate them per user on the server, for example with an OpenFeature provider, and pass the results to the client. A flagged API route checks the flag too, so a hidden button is no way around it. Remove flags when they are done, as stale flags describes.

Example

@app.get("/api/session")
def session_info():
    user = current_user()
    return {
        "user": {"id": user.id, "name": user.display_name},
        "flags": {"newReports": flags.is_enabled("new-reports", user=user, default=False)},
    }

const session = await api.get('/api/session');
const app = createApp({ flags: session.flags });
if (session.flags.newReports) app.addRoute({ path: '/reports', load: () => import('./reports/ReportsScreen') });

How to check

A browser test loads the screen with the flag off and records every frame for one second. The flagged control never appears. A direct API call to the flagged route gets 404.