chore: updated setup guide ad readme for correctness

Author: Davidthecode

.github/CONTRIBUTING.md

@@ -201,6 +201,52 @@ RESEND_API_KEY=<YOUR_RESEND_API_KEY>
 TINYBIRD_TOKEN=<YOUR_TINYBIRD_TOKEN>
 ```
 
+## Local Development with SDKs
+
+When testing the SDKs locally with a local API server running on `localhost:5000`, you'll need to configure the `__internal_baseUrl` option to point to your local development server instead of the production API.
+
+### Using SDKs Locally
+
+For **JavaScript SDK**:
+
+```javascript
+import { Flagix } from "@flagix/js-sdk";
+
+await Flagix.initialize({
+  apiKey: "your-dev-api-key",
+  __internal_baseUrl: "http://localhost:5000", // Points to local API server
+  initialContext: {
+    userId: "test_user",
+    email: "test@example.com"
+  }
+});
+```
+
+For **React SDK**:
+
+```jsx
+import { FlagixProvider } from "@flagix/react";
+
+const options = {
+  apiKey: "your-dev-api-key",
+  __internal_baseUrl: "http://localhost:5000", // Points to local API server
+  initialContext: {
+    userId: "test_user",
+    email: "test@example.com"
+  }
+};
+
+function App() {
+  return (
+    <FlagixProvider options={options}>
+      <YourApp />
+    </FlagixProvider>
+  );
+}
+```
+
+**Note:** The `__internal_baseUrl` option is for local development and testing only. Do not include it in production code—the SDK will automatically use the production API endpoint.
+
 ## Running the Apps
 
 From the root you can run all apps:

README.md

@@ -55,7 +55,6 @@ import { Flagix } from "@flagix/js-sdk";
 // Initialize the SDK. 
 await Flagix.initialize({
   apiKey: "<YOUR_API_KEY>",
-  apiBaseUrl: "https://api.flagix.com",
 });
 
 // Set user context (triggers instant re-evaluation)
@@ -82,7 +81,6 @@ import { useAuth } from "./hooks/use-auth";
 
 const options = {
   apiKey: "<YOUR_API_KEY>",
-  apiBaseUrl: "https://api.flagix.com",
 };
 
 export default function Providers({ children }: { children: React.ReactNode }) {

apps/docs/content/docs/environments.mdx

@@ -80,7 +80,6 @@ const env = process.env.NODE_ENV; // "development", "staging", "production"
 // Initialize Flagix with environment-specific API key
 await Flagix.initialize({
   apiKey: process.env[`FLAGIX_API_KEY_${env.toUpperCase()}`],
-  apiBaseUrl: process.env.FLAGIX_API_URL,
   initialContext: {
     userId: user.id,
     environment: env

apps/docs/content/docs/index.mdx

@@ -34,7 +34,6 @@ import { Flagix } from "@flagix/js-sdk";
 
 await Flagix.initialize({
   apiKey: "your-api-key",
-  apiBaseUrl: "https://api.flagix.com",
   initialContext: {
     userId: "user_123",
     email: "user@example.com",
@@ -67,7 +66,6 @@ import { FlagixProvider } from "@flagix/react";
 function App() {
   const options = {
     apiKey: "your-api-key",
-    apiBaseUrl: "https://api.flagix.com",
     initialContext: { userId: "user_123" }
   }
 

apps/docs/content/docs/installation.mdx

@@ -54,7 +54,6 @@ import { Flagix } from "@flagix/js-sdk";
 // Initialize the SDK
 await Flagix.initialize({
   apiKey: "your-api-key-here",
-  apiBaseUrl: "https://api.flagix.com",
   initialContext: {
     userId: "user_123",
     email: "user@example.com",
@@ -71,17 +70,14 @@ Wrap your application with the `FlagixProvider` (see the [React & Next.js SDK re
 **Simple React example:**
 ```jsx
 import { FlagixProvider } from "@flagix/react";
-
 const options = {
   apiKey: "your-api-key-here",
-  apiBaseUrl: "https://api.flagix.com",
   initialContext: {
     userId: "user_123",
     email: "user@example.com",
     plan: "premium"
   },
 };
-
 function App() {
   return (
     <FlagixProvider options={options}>
@@ -98,7 +94,6 @@ import { useAuth } from "./hooks/use-auth"; // Your auth hook
 
 const options = {
   apiKey: "your-api-key-here",
-  apiBaseUrl: "https://api.flagix.com",
 };
 
 function App() {
@@ -123,7 +118,6 @@ For **Next.js App Router**, create a `providers.tsx` file and wrap your root lay
 | Option | Type | Required | Description |
 |--------|------|----------|-------------|
 | `apiKey` | `string` | ✅ | Your Flagix API key |
-| `apiBaseUrl` | `string` | ✅ | Base URL for the Flagix API |
 | `initialContext` | `object` | ❌ | Initial evaluation context |
 | `context` (React only) | `object` | ❌ | Dynamic context that syncs automatically |
 | `logs.level` | `string` | ❌ | Set to `info`, `warn`, or `error` to see internal SDK logs in the console. |
@@ -137,15 +131,13 @@ Store your API credentials in environment variables:
 ```bash
 # .env
 FLAGIX_API_KEY=your-api-key
-FLAGIX_API_URL=https://api.flagix.com
 ```
 
 Then in your code:
 
 ```javascript
 await Flagix.initialize({
   apiKey: process.env.FLAGIX_API_KEY,
-  apiBaseUrl: process.env.FLAGIX_API_URL,
   initialContext: { userId: "user_123" }
 });
 ```
@@ -157,15 +149,13 @@ Environment variables must be prefixed with `NEXT_PUBLIC_` to be accessible in t
 ```bash
 # .env
 NEXT_PUBLIC_FLAGIX_API_KEY=your-api-key
-NEXT_PUBLIC_FLAGIX_API_URL=https://api.flagix.com
 ```
 
 Then use them in your provider component:
 
 ```jsx
 const options = {
   apiKey: process.env.NEXT_PUBLIC_FLAGIX_API_KEY,
-  apiBaseUrl: process.env.NEXT_PUBLIC_FLAGIX_API_URL,
 };
 ```
 

apps/docs/content/docs/sdk/javascript.mdx

@@ -24,7 +24,6 @@ async initialize(options: FlagixClientOptions): Promise<void>
 ```typescript
 interface FlagixClientOptions {
   apiKey: string;                    // Required: Your API key
-  apiBaseUrl: string;                 // Required: base URL
   initialContext?: EvaluationContext; // Optional: Initial context
   logs?: {
     level?: "none" | "error" | "warn" | "info"; // Optional: default "none"
@@ -39,7 +38,6 @@ import { Flagix } from "@flagix/js-sdk";
 
 await Flagix.initialize({
   apiKey: "your-api-key",
-  apiBaseUrl: "https://api.flagix.com",
   initialContext: {
     userId: "user_123",
     email: "user@example.com",
@@ -161,6 +159,57 @@ Flagix.setContext({
 // → Reactive updates triggered again
 ```
 
+### Flagix.identify()
+
+Replaces the entire global evaluation context, clearing all previous context values.
+
+```typescript
+identify(newContext: EvaluationContext): void
+```
+
+#### Parameters
+
+- `newContext` - New context object that will completely replace the existing context
+
+#### Use Cases
+
+Unlike `setContext()` which merges with existing context, `identify()` is useful when you need to:
+
+- **Clear user context on logout**: Remove all user-specific attributes
+- **Switch between different users**: Replace one user's context entirely with another's
+- **Reset evaluation context**: Start fresh with a completely new context
+
+#### Reactivity
+
+Calling `identify()` instantly replaces the global context and triggers re-evaluation of all cached flags. Any active listeners subscribed via `onFlagUpdate()` are triggered.
+
+#### Examples
+
+```javascript
+// On user logout - completely clear context
+Flagix.identify({});
+// → All previous context is removed
+// → All flags re-evaluate with empty context
+// → All onFlagUpdate listeners are triggered
+
+// Switch to a different user
+Flagix.identify({
+  userId: "new_user_456",
+  email: "newuser@example.com",
+  plan: "basic"
+});
+// → Previous context is completely replaced
+// → No old user data persists
+// → Flags re-evaluate with new user context
+
+// Distinguish between setContext and identify
+// Use setContext for incremental updates
+Flagix.setContext({ lastActivity: new Date() });
+
+// Use identify for complete context replacement
+Flagix.identify({ userId: "user_new", role: "admin" });
+```
+
 ### Flagix.onFlagUpdate()
 
 Subscribes to real-time flag updates triggered by `setContext()` or server-sent events.

apps/docs/content/docs/sdk/react.mdx

@@ -24,7 +24,6 @@ import { FlagixProvider } from "@flagix/react";
 
 const options = {
   apiKey: "your-api-key",
-  apiBaseUrl: "https://api.flagix.com",
   initialContext: {
     userId: "user_123",
     email: "user@example.com",
@@ -59,7 +58,6 @@ import type React from "react";
 
 const flagixOptions = {
   apiKey: "your-api-key",
-  apiBaseUrl: "https://api.flagix.com",
   initialContext: {
     userId: "user_123",
     email: "user@example.com",
@@ -111,7 +109,6 @@ import { FlagixProvider } from "@flagix/react";
 
 const flagixOptions = {
   apiKey: "your-api-key",
-  apiBaseUrl: "https://api.flagix.com",
   initialContext: {
     userId: "user_123",
     email: "user@example.com",
@@ -157,7 +154,6 @@ import { FlagixProvider } from "@flagix/react";
 
 const options = {
   apiKey: "your-api-key",
-  apiBaseUrl: "https://api.flagix.com",
   initialContext: {
     userId: "user_123",
     email: "user@example.com",
@@ -186,7 +182,6 @@ import { useAuth } from "./hooks/use-auth"; // Your auth hook
 
 const options = {
   apiKey: "your-api-key",
-  apiBaseUrl: "https://api.flagix.com",
 };
 
 function App() {
@@ -262,52 +257,50 @@ Hook for accessing Flagix actions like tracking events and updating context.
 function useFlagixActions(): {
   track: (eventName: string, properties?: Record<string, unknown>) => void;
   setContext: (newContext: EvaluationContext) => void;
+  identify: (context?: EvaluationContext) => void;
 }
 ```
 
-#### When to Use `setContext()`
+#### track()
 
-While the `context` prop on `FlagixProvider` is the recommended way to manage global user state, `setContext()` is still available for:
+Records custom events for analytics and conversion tracking.
 
-- **Temporary overrides**: Quick testing or short-lived changes that don't warrant provider state updates
-- **Manual updates**: Fine-grained control in edge cases
-- **Vanilla JavaScript**: Applications not using a provider pattern
+```jsx
+const { track } = useFlagixActions();
 
-For most authenticated applications, prefer passing user state via the `context` prop for cleaner, more declarative code.
+track("purchase_completed", {
+  amount: 99.99,
+  currency: "USD",
+  productId: "prod_123"
+});
+```
 
-#### Examples
+See [Flagix.track()](/docs/sdk/javascript#flagixtrack) in the JavaScript SDK for details.
+
+#### setContext()
+
+Merges new attributes with existing context. Use for incremental updates.
 
 ```jsx
-import { useFlagixActions } from "@flagix/react";
+const { setContext } = useFlagixActions();
 
-function PurchaseButton() {
-  const { track } = useFlagixActions();
-  
-  const handlePurchase = () => {
-    // Track purchase event
-    track("purchase_completed", {
-      amount: 99.99,
-      currency: "USD",
-      productId: "prod_123"
-    });
-    
-    // Process purchase...
-  };
-  
-  return <button onClick={handlePurchase}>Buy Now</button>;
-}
+setContext({ plan: "premium" }); // Adds/updates plan, keeps other context
+```
 
-function TestComponent() {
-  const { setContext } = useFlagixActions();
-  
-  // Temporary context override for testing
-  const handleTestAsAdmin = () => {
-    setContext({ role: "admin" });
-  };
-  
-  return <button onClick={handleTestAsAdmin}>Test Admin Features</button>;
-}
+See [Flagix.setContext()](/docs/sdk/javascript#flagixsetcontext) in the JavaScript SDK for details.
+
+#### identify()
+
+Replaces entire context. Use for logout or switching users.
+
+```jsx
+const { identify } = useFlagixActions();
+
+identify({}); // Logout - clears all context
+identify({ userId: "new_user", plan: "free" }); // Switch user
 ```
----
+
+See [Flagix.identify()](/docs/sdk/javascript#flagixidentify) in the JavaScript SDK for details.
+
 
 Need help? [contact support](https://x.com/flagixx).

apps/web/components/environment/setup-snippets.ts

@@ -9,7 +9,6 @@ import { useAuth } from "./hooks/use-auth"; // Your auth hook
 
 const options = {
   apiKey: "${apiKey}",
-  apiBaseUrl: "https://api.flagix.com",
 };
 
 export default function Providers({ children }: { children: React.ReactNode }) {
@@ -45,7 +44,6 @@ export default function MyComponent() {
 // Initialize the SDK.  
 await Flagix.initialize({
   apiKey: "${apiKey}",
-  apiBaseUrl: "https://api.flagix.com",
 });
 
 // Set user identity (triggers instant re-evaluation)

apps/web/components/home/hero.tsx

@@ -22,7 +22,7 @@ export const HeroSection = () => (
       <div className="group inline-flex items-center space-x-2 rounded-full border border-gray-300/50 bg-white/50 px-3 py-1 backdrop-blur-sm transition-all hover:border-gray-400">
         <span className="flex h-2 w-2 animate-pulse rounded-full bg-green-500" />
         <span className="font-medium text-gray-600 text-xs uppercase tracking-tight">
-          v1.2.0 is live
+          v1.0 is live
         </span>
         <div className="h-3 w-px bg-gray-300" />
         <Link