xingxinglieo · Feb 5, 2026 · Feb 5, 2026
diff --git a/LICENSE b/LICENSE
diff --git a/README.md b/README.md
@@ -1,24 +1,24 @@
-# statsig
+# @lovart-open/flags
 
-[![CI](https://github.com/lovartai/flags/actions/workflows/ci.yml/badge.svg)](https://github.com/lovartai/flags/actions/workflows/ci.yml)
-[![npm version](https://img.shields.io/npm/v/statsig.svg)](https://www.npmjs.com/package/statsig)
+[![CI](https://github.com/lovartai/statsig/actions/workflows/ci.yml/badge.svg)](https://github.com/lovartai/statsig/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/@lovart-open/flags.svg)](https://www.npmjs.com/package/@lovart-open/flags)
 
 Type-safe Feature Flag and Parameter Store library built on Statsig, with a fully synchronous architecture.
 
 ## Installation
 
 ```bash
-npm install statsig
+npm install @lovart-open/flags
 # or
-pnpm add statsig
+pnpm add @lovart-open/flags
 ```
 
 ## Initialize Statsig
 
 Initialize the Statsig client at your app entry point:
 
 ```ts
-import { initStatsigClient } from 'statsig';
+import { initStatsigClient } from '@lovart-open/flags/statsig';
 
 initStatsigClient('your-statsig-client-key', { userID: 'user-123' }, {
   environment: { tier: 'production' },
@@ -38,7 +38,7 @@ initStatsigClient('your-statsig-client-key', { userID: 'user-123' }, {
 ## Define and Create
 
 ```ts
-import { createFlagStore, type FlagDefinition } from 'statsig';
+import { createFlagStore, type FlagDefinition } from '@lovart-open/flags/statsig';
 
 // 1. Define your flags
 const MY_FLAGS = {
@@ -120,7 +120,7 @@ import {
   createParamStore, 
   defineParam, 
   type ParamStoreDefinition 
-} from 'statsig';
+} from '@lovart-open/flags/statsig';
 
 // 1. Define your param stores
 const MY_PARAMS = {
@@ -217,9 +217,15 @@ store.get('currency');  // 'USD' | 'CNY' | 'EUR'
 ## Custom Logger
 
 ```ts
+import { initStatsigClient, setLogger } from '@lovart-open/flags/statsig';
+
+// Option 1: Pass during init
 initStatsigClient('client-xxx', { userID: 'user-123' }, {
-  logger: (message, data) => myLogger.info(message, data),
+  logger: (message) => myLogger.info(message),
 });
+
+// Option 2: Set globally
+setLogger((message) => myLogger.info(message));
 ```
 
 ## E2E Test Support
@@ -237,6 +243,16 @@ await page.addInitScript(() => {
 });
 ```
 
+## Server-Side Bootstrap (Zero-Network Init)
+
+```ts
+initStatsigClient('client-xxx', { userID: 'user-123' }, {
+  bootstrap: {
+    data: bootstrapDataFromServer,  // Pre-fetched from BFF
+  },
+});
+```
+
 ## FlagDefinition Options
 
 | Property | Type | Description |

diff --git a/package.json b/package.json
@@ -1,13 +1,17 @@
 {
-  "name": "@lovart-open/statsig",
-  "version": "1.0.0",
+  "name": "@lovart-open/flags",
+  "version": "0.0.1",
   "description": "Feature flag management with multi-layer priority system (client-side)",
   "main": "src/index.ts",
   "types": "src/index.ts",
   "exports": {
     ".": {
       "types": "./src/index.ts",
       "default": "./src/index.ts"
+    },
+    "./statsig": {
+      "types": "./src/statsig/index.ts",
+      "default": "./src/statsig/index.ts"
     }
   },
   "files": [
@@ -27,7 +31,6 @@
   "dependencies": {
     "@statsig/js-client": "^3.30.0",
     "@statsig/react-bindings": "^3.30.2",
-    "@statsig/web-analytics": "^3.30.0",
     "lodash": "^4.17.21",
     "zod": "^3.23.0"
   },

diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
diff --git a/src/__tests__/flag-store.test.ts b/src/__tests__/flag-store.test.ts
@@ -1,7 +1,7 @@
 // Mock external dependencies
 const mockGetFeatureGate = vi.fn();
 const mockIsTestEnv = vi.fn(() => false);
-vi.mock('../statsig', () => ({
+vi.mock('../statsig/client', () => ({
   getStatsigClientSync: vi.fn(() => ({
     getFeatureGate: mockGetFeatureGate,
   })),
@@ -10,7 +10,7 @@ vi.mock('../statsig', () => ({
 
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 
-import { createFlagStore, type FlagDefinition } from '../flags';
+import { createFlagStore, type FlagDefinition } from '../statsig';
 
 describe('FlagStore', () => {
   const mockFlags = {

diff --git a/src/__tests__/param-store.test.ts b/src/__tests__/param-store.test.ts
@@ -3,15 +3,14 @@ import { z } from 'zod';
 
 // Mock statsig
 const mockIsTestEnv = vi.fn(() => false);
-vi.mock('../statsig', () => ({
+vi.mock('../statsig/client', () => ({
   getStatsigClientSync: vi.fn(() => ({
     getParameterStore: vi.fn(),
   })),
   isTestEnv: () => mockIsTestEnv(),
 }));
 
-import { createParamStore, defineParam, type ParamStoreDefinition } from '../params';
-import { getStatsigClientSync } from '../statsig';
+import { createParamStore, defineParam, type ParamStoreDefinition, getStatsigClientSync } from '../statsig';
 
 describe('ParamStore', () => {
   const testStores = {

diff --git a/src/index.ts b/src/index.ts
@@ -1,54 +1,12 @@
 /**
- * statsig
+ * @lovart-open/flags
  *
- * Type-safe Feature Flag and Parameter Store management library.
+ * This package uses subpath exports. Import from:
+ * - @lovart-open/flags/statsig - Statsig-based feature flags and parameter stores
  *
- * Feature flag priority: URL > testOverride > override > remote > fallback(false)
- * Parameter Store priority: URL > testOverride > override > remote > fallback
+ * @example
+ * import { createFlagStore, createParamStore } from '@lovart-open/flags/statsig';
  */
 
-// Flag factory and types
-export { createFlagStore, FlagStore, parseUrlOverrides, type ResolveOptions } from './flags';
-
-// Param factory and types
-export {
-  createParamStore,
-  defineParam,
-  PARAM_SCHEMA_MISMATCH_EVENT,
-  type ParamSchemaMismatchDetail,
-  parseParamStoreUrlOverrides,
-  ParamStore,
-  type ParamDefinition,
-  type ParamResolveOptions,
-  type ParamState,
-  type ParamStoreDefinition,
-  type ParamStoreHandle,
-  type ParamStoreValue,
-} from './params';
-
-// Logger
-export { getLogger, type Logger } from './logger';
-
-// Statsig integration
-export {
-  getStatsigClientSync,
-  initStatsigClient,
-  isTestEnv,
-  type InitOptions,
-  type StatsigBootstrap,
-} from './statsig';
-
-// Core types
-export {
-  type EvaluationOptions,
-  type FeatureGate,
-  type FlagDefinition,
-  type FlagKeyOf,
-  type FlagPriority,
-  type FlagSnapshot,
-  type FlagState,
-  type RemoteFlagValues,
-} from './types';
-
-// Statsig React bindings (re-export)
-export * from '@statsig/react-bindings';
+// No exports from root path - use subpath imports
+export {};
diff --git a/src/statsig/client.ts b/src/statsig/client.ts
@@ -5,7 +5,7 @@
 
 import { StatsigClient, type StatsigOptions, type StatsigUser } from '@statsig/js-client';
 
-import { getLogger, type Logger, setLogger } from '../logger';
+import { getLogger, type Logger, setLogger } from './logger';
 
 let client: StatsigClient | null = null;
 let testEnvDetector: (() => boolean) | null = null;

diff --git a/src/flags.ts → src/statsig/flags.ts b/src/flags.ts → src/statsig/flags.ts
@@ -5,7 +5,7 @@
 
 import { useFeatureGate } from '@statsig/react-bindings';
 
-import { getStatsigClientSync, isTestEnv } from './statsig';
+import { getStatsigClientSync, isTestEnv } from './client';
 import type { EvaluationOptions, FeatureGate, FlagDefinition, FlagSnapshot, FlagState } from './types';
 
 export interface ResolveOptions extends EvaluationOptions {

diff --git a/src/statsig/index.ts b/src/statsig/index.ts
@@ -1,11 +1,54 @@
 /**
- * Statsig module exports.
+ * @lovart-open/flags/statsig
+ *
+ * Type-safe Feature Flag and Parameter Store management library.
+ *
+ * Feature flag priority: URL > testOverride > override > remote > fallback(false)
+ * Parameter Store priority: URL > testOverride > override > remote > fallback
  */
 
+// Flag factory and types
+export { createFlagStore, FlagStore, parseUrlOverrides, type ResolveOptions } from './flags';
+
+// Param factory and types
+export {
+  createParamStore,
+  defineParam,
+  PARAM_SCHEMA_MISMATCH_EVENT,
+  type ParamSchemaMismatchDetail,
+  parseParamStoreUrlOverrides,
+  ParamStore,
+  type ParamDefinition,
+  type ParamResolveOptions,
+  type ParamState,
+  type ParamStoreDefinition,
+  type ParamStoreHandle,
+  type ParamStoreValue,
+} from './params';
+
+// Logger
+export { getLogger, setLogger, type Logger } from './logger';
+
+// Statsig client
 export {
   getStatsigClientSync,
   initStatsigClient,
   isTestEnv,
   type InitOptions,
   type StatsigBootstrap,
 } from './client';
+
+// Core types
+export {
+  type EvaluationOptions,
+  type FeatureGate,
+  type FlagDefinition,
+  type FlagKeyOf,
+  type FlagPriority,
+  type FlagSnapshot,
+  type FlagState,
+  type RemoteFlagValues,
+} from './types';
+
+// Statsig React bindings (re-export)
+export * from '@statsig/react-bindings';
diff --git a/src/logger.ts → src/statsig/logger.ts b/src/logger.ts → src/statsig/logger.ts
diff --git a/src/params.ts → src/statsig/params.ts b/src/params.ts → src/statsig/params.ts
@@ -7,7 +7,7 @@ import { merge, set } from 'lodash';
 import { useParameterStore } from '@statsig/react-bindings';
 import z from 'zod';
 
-import { getStatsigClientSync, isTestEnv } from './statsig';
+import { getStatsigClientSync, isTestEnv } from './client';
 
 /** Parameter definition */
 export interface ParamDefinition<T = unknown> {

diff --git a/src/types.ts → src/statsig/types.ts b/src/types.ts → src/statsig/types.ts