React components and hooks for seamless Brave Ship feature flag integration.
@farmart-tech/brave-react-adapter provides a set of React contexts and hooks to easily consume feature flags in any React application.
useFeatureEnabled for clean integration.FeatureFlagGate and FeatureVariant components.npm install @farmart-tech/brave-react-adapter
# or
pnpm add @farmart-tech/brave-react-adapter
react >=18.0.0firebase ^11.5.0@farmart-tech/brave-admin-sdk (provides core types)import { FeatureReaderProvider } from '@farmart-tech/brave-react-adapter';
import { getFirestore } from 'firebase/firestore';
const db = getFirestore(app);
function Root() {
return (
<FeatureReaderProvider
workspace="production"
db={db}
userContext={{ userId: 'user-123' }}
>
<App />
</FeatureReaderProvider>
);
}
import { useFeatureEnabled } from '@farmart-tech/brave-react-adapter';
function Dashboard() {
const isEnabled = useFeatureEnabled('new_analytics_dashboard');
if (isEnabled === null) return <Loading />;
return isEnabled ? <NewDashboard /> : <StandardDashboard />;
}
By default, resolved evaluations are stored in local storage for seven days. The cache key includes the workspace, environment, and user context, and every value is revalidated immediately. Applications that must fail closed on every startup can disable this behavior:
<FeatureReaderProvider
featureReaderConfig={config}
featureEvaluationCache={{ enabled: false }}
>
<App />
</FeatureReaderProvider>
import { FeatureFlagGate } from '@farmart-tech/brave-react-adapter';
function ProfilePage() {
return (
<FeatureFlagGate
flag="edit_profile_v2"
fallback={<SimpleProfile />}
>
<AdvancedProfileEditor />
</FeatureFlagGate>
);
}
Comprehensive API documentation is available at: https://fmt-feature-management.web.app/docs/react-adapter/
MIT © FarMart