onedollarstats 0.0.19 → 0.0.21

package/README.md

@@ -119,6 +119,45 @@ event("Purchase", "/product", { amount: 1, color: "green" });
 - `pathOrProps` – Optional, **string** represents the path, **object** represents custom properties.
 - `props` – Optional, properties if the second argument is a path string.
 
+## Expo
+
+`onedollarstats/expo` is a dedicated entry point for Expo apps using `expo-router`. It auto-collects pageviews on route change and on app foreground, supports dynamic-route templates (`/profile/[id]` instead of `/profile/abc123`), and sends events natively on iOS/Android and via image beacon + `sendBeacon` on web.
+
+```tsx
+// app/_layout.tsx
+import { Stack } from 'expo-router';
+import { OneDollarStatsProvider } from 'onedollarstats/expo';
+
+export default function RootLayout() {
+  return (
+    <OneDollarStatsProvider config={{ hostname: 'example.com' }}>
+      <Stack screenOptions={{ headerShown: false }} />
+    </OneDollarStatsProvider>
+  );
+}
+```
+
+Fire custom events or manual pageviews from any component with `useAnalytics()`:
+
+```tsx
+import { useAnalytics } from 'onedollarstats/expo';
+
+const { event, view } = useAnalytics();
+
+event('signup', { plan: 'pro' });        // event with current route
+event('signup', '/landing');              // event with explicit path
+view({ campaign: 'spring' });             // pageview with just props
+view('/landing', { campaign: 'spring' }); // pageview with explicit path
+```
+
+**Expo-specific config options:**
+
+| Option                  | Type       | Default | Description                                                                                  |
+| ----------------------- | ---------- | ------- | -------------------------------------------------------------------------------------------- |
+| `collapseDynamicRoutes` | `boolean`  | `true`  | Use `useSegments()` to record routes as templates (`/profile/[id]`) instead of concrete paths. Group segments like `(tabs)` are stripped. |
+
+All other options (`hostname`, `collectorUrl`, `devmode`, `autocollect`, `excludePages`, `includePages`) behave the same as in the web tracker above.
+
 ## Autocapture
 
 **Page view events**

package/dist/expo.d.ts

@@ -0,0 +1,35 @@
+import { type MutableRefObject, type ReactNode } from 'react';
+export type ExpoAnalyticsConfig = {
+    hostname: string;
+    collectorUrl?: string;
+    excludePages?: string[];
+    includePages?: string[];
+    autocollect?: boolean;
+    devmode?: boolean;
+    collapseDynamicRoutes?: boolean;
+};
+type InternalConfig = {
+    hostname: string;
+    collectorUrl: string;
+    autocollect: boolean;
+    devmode: boolean;
+    collapseDynamicRoutes: boolean;
+    excludePages?: string[];
+    includePages?: string[];
+};
+type ContextValue = {
+    config: InternalConfig;
+    lastPathRef: MutableRefObject<string | null>;
+};
+export type OneDollarStatsProviderProps = {
+    config: ExpoAnalyticsConfig;
+    children: ReactNode;
+};
+export declare function OneDollarStatsProvider({ config, children }: OneDollarStatsProviderProps): import("react").FunctionComponentElement<import("react").ProviderProps<ContextValue | null>>;
+type Props = Record<string, string>;
+export type AnalyticsAPI = {
+    event(eventName: string, pathOrProps?: string | Props, props?: Props): void;
+    view(pathOrProps?: string | Props, props?: Props): void;
+};
+export declare function useAnalytics(): AnalyticsAPI;
+export {};

package/dist/expo.js

@@ -0,0 +1,201 @@
+import {
+  createContext,
+  createElement,
+  useCallback,
+  useContext,
+  useEffect,
+  useMemo,
+  useRef
+} from "react";
+import { AppState, Platform } from "react-native";
+import { usePathname, useSegments } from "expo-router";
+const Context = createContext(null);
+function mergeConfig(config) {
+  return {
+    hostname: config.hostname,
+    collectorUrl: config.collectorUrl ?? "https://collector.onedollarstats.com/events",
+    autocollect: config.autocollect ?? true,
+    devmode: config.devmode ?? false,
+    collapseDynamicRoutes: config.collapseDynamicRoutes ?? true,
+    excludePages: config.excludePages,
+    includePages: config.includePages
+  };
+}
+function isGroupSegment(segment) {
+  return /^\(.+\)$/.test(segment);
+}
+function collapsePath(segments) {
+  const visible = segments.filter((s) => !isGroupSegment(s));
+  if (visible.length === 0) return "/";
+  return "/" + visible.join("/");
+}
+function useTrackedPath(config) {
+  const pathname = usePathname();
+  const segments = useSegments();
+  return config.collapseDynamicRoutes ? collapsePath(segments) : pathname;
+}
+function isWebLocalhost() {
+  if (Platform.OS !== "web") return false;
+  if (typeof window === "undefined" || !window.location) return false;
+  const { hostname, protocol } = window.location;
+  return /^localhost$|^127(\.[0-9]+){0,2}\.[0-9]+$|^\[::1?\]$/.test(hostname) && (protocol === "http:" || protocol === "https:");
+}
+function useRequiredContext(caller) {
+  const ctx = useContext(Context);
+  if (!ctx) {
+    throw new Error(
+      `[onedollarstats] ${caller} must be used inside <OneDollarStatsProvider>. Wrap your root layout with the provider.`
+    );
+  }
+  return ctx;
+}
+function OneDollarStatsProvider({ config, children }) {
+  const merged = useMemo(
+    () => mergeConfig(config),
+    [
+      config.hostname,
+      config.collectorUrl,
+      config.autocollect,
+      config.devmode,
+      config.collapseDynamicRoutes,
+      config.excludePages,
+      config.includePages
+    ]
+  );
+  const lastPathRef = useRef(null);
+  const announcedRef = useRef(false);
+  const trackedPath = useTrackedPath(merged);
+  useEffect(() => {
+    if (announcedRef.current) return;
+    if (merged.devmode && isWebLocalhost()) {
+      console.log(
+        `[onedollarstats]
+OneDollarStats connected! Tracking localhost as ${merged.hostname}`
+      );
+    }
+    announcedRef.current = true;
+  }, [merged.devmode, merged.hostname]);
+  useEffect(() => {
+    if (!merged.autocollect) return;
+    if (isExcluded(trackedPath, merged)) return;
+    if (lastPathRef.current === trackedPath) return;
+    lastPathRef.current = trackedPath;
+    send("PageView", trackedPath, merged);
+  }, [trackedPath, merged]);
+  useEffect(() => {
+    const handler = (state) => {
+      if (state !== "active") return;
+      if (!merged.autocollect) return;
+      const current = lastPathRef.current;
+      if (!current || isExcluded(current, merged)) return;
+      send("PageView", current, merged);
+    };
+    const sub = AppState.addEventListener("change", handler);
+    return () => sub.remove();
+  }, [merged]);
+  const value = useMemo(
+    () => ({ config: merged, lastPathRef }),
+    [merged]
+  );
+  return createElement(Context.Provider, { value }, children);
+}
+function useAnalytics() {
+  const ctx = useRequiredContext("useAnalytics");
+  const trackedPath = useTrackedPath(ctx.config);
+  const event = useCallback(
+    (eventName, pathOrProps, props) => {
+      const targetPath = typeof pathOrProps === "string" ? pathOrProps : trackedPath;
+      const eventProps = typeof pathOrProps === "object" ? pathOrProps : props;
+      send(eventName, targetPath, ctx.config, eventProps);
+    },
+    [ctx, trackedPath]
+  );
+  const view = useCallback(
+    (pathOrProps, props) => {
+      const targetPath = typeof pathOrProps === "string" ? pathOrProps : trackedPath;
+      const viewProps = typeof pathOrProps === "object" ? pathOrProps : props;
+      send("PageView", targetPath, ctx.config, viewProps);
+    },
+    [ctx, trackedPath]
+  );
+  return { event, view };
+}
+function shouldSkipSend(config) {
+  if (Platform.OS !== "web") return false;
+  if (isWebLocalhost() && !config.devmode) return true;
+  return false;
+}
+function devLog(label, url, props) {
+  let msg = `[onedollarstats]
+Event name: ${label}
+Event collected from: ${url}`;
+  if (props && Object.keys(props).length > 0) {
+    msg += `
+Props: ${JSON.stringify(props, null, 2)}`;
+  }
+  console.log(msg);
+}
+const SAFE_GET_THRESHOLD = 1500;
+function send(eventName, path, config, props) {
+  if (shouldSkipSend(config)) return;
+  const url = `https://${config.hostname}${path}`;
+  if (config.devmode) devLog(eventName, url, props);
+  const body = JSON.stringify({
+    u: url,
+    e: [{ t: eventName, ...props && { p: props } }]
+  });
+  if (Platform.OS === "web") {
+    sendWeb(config.collectorUrl, body);
+  } else {
+    sendNative(config.collectorUrl, body);
+  }
+}
+function sendNative(collectorUrl, body) {
+  fetch(collectorUrl, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body
+  }).catch(() => {
+  });
+}
+function sendWeb(collectorUrl, body) {
+  const bytes = new TextEncoder().encode(body);
+  const bin = String.fromCharCode(...bytes);
+  const payloadBase64 = btoa(bin);
+  if (payloadBase64.length <= SAFE_GET_THRESHOLD) {
+    const img = new Image(1, 1);
+    img.onerror = () => sendBeaconOrFetch(collectorUrl, body);
+    img.src = `${collectorUrl}?data=${payloadBase64}`;
+    return;
+  }
+  sendBeaconOrFetch(collectorUrl, body);
+}
+function sendBeaconOrFetch(collectorUrl, body) {
+  if (typeof navigator !== "undefined" && navigator.sendBeacon?.(collectorUrl, body)) {
+    return;
+  }
+  fetch(collectorUrl, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body,
+    keepalive: true
+  }).catch(() => {
+  });
+}
+function pathMatches(path, prefix) {
+  return path === prefix || path.startsWith(prefix.endsWith("/") ? prefix : prefix + "/");
+}
+function isExcluded(path, config) {
+  if (config.includePages?.length) {
+    return !config.includePages.some((p) => pathMatches(path, p));
+  }
+  if (config.excludePages?.length) {
+    return config.excludePages.some((p) => pathMatches(path, p));
+  }
+  return false;
+}
+export {
+  OneDollarStatsProvider,
+  useAnalytics
+};
+//# sourceMappingURL=expo.js.map

package/dist/expo.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/expo.ts"],
+  "sourcesContent": ["import {\n  createContext,\n  createElement,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n  type MutableRefObject,\n  type ReactNode\n} from 'react';\nimport { AppState, Platform, type AppStateStatus } from 'react-native';\nimport { usePathname, useSegments } from 'expo-router';\n\nexport type ExpoAnalyticsConfig = {\n  hostname: string;\n  collectorUrl?: string;\n  excludePages?: string[];\n  includePages?: string[];\n  autocollect?: boolean;\n  devmode?: boolean;\n  collapseDynamicRoutes?: boolean;\n};\n\ntype InternalConfig = {\n  hostname: string;\n  collectorUrl: string;\n  autocollect: boolean;\n  devmode: boolean;\n  collapseDynamicRoutes: boolean;\n  excludePages?: string[];\n  includePages?: string[];\n};\n\n// TODO(page-scope): restore when page-scope detection is designed.\n/*\ntype OverrideSource = 'hook' | 'component';\ntype Override = { realPath: string; customPath: string; source: OverrideSource } | null;\ntype PropsOverride =\n  | { realPath: string; props: Record<string, string>; source: OverrideSource }\n  | null;\n*/\n\ntype ContextValue = {\n  config: InternalConfig;\n  lastPathRef: MutableRefObject<string | null>;\n  // TODO(page-scope): restore when page-scope detection is designed.\n  // overrideRef: MutableRefObject<Override>;\n  // propsOverrideRef: MutableRefObject<PropsOverride>;\n};\n\nconst Context = createContext<ContextValue | null>(null);\n\n// TODO(page-scope): restore when page-scope detection is designed.\n/*\nfunction resolvePath(pathname: string, overrideRef: MutableRefObject<Override>): string {\n  const o = overrideRef.current;\n  return o && o.realPath === pathname ? o.customPath : pathname;\n}\n\nfunction resolveProps(\n  pathname: string,\n  propsOverrideRef: MutableRefObject<PropsOverride>\n): Record<string, string> | undefined {\n  const o = propsOverrideRef.current;\n  return o && o.realPath === pathname ? o.props : undefined;\n}\n\nfunction mergeProps(\n  screenProps: Record<string, string> | undefined,\n  explicitProps: Record<string, string> | undefined\n): Record<string, string> | undefined {\n  if (!screenProps && !explicitProps) return undefined;\n  if (!screenProps) return explicitProps;\n  if (!explicitProps) return screenProps;\n  return { ...screenProps, ...explicitProps };\n}\n*/\n\nfunction mergeConfig(config: ExpoAnalyticsConfig): InternalConfig {\n  return {\n    hostname: config.hostname,\n    collectorUrl: config.collectorUrl ?? 'https://collector.onedollarstats.com/events',\n    autocollect: config.autocollect ?? true,\n    devmode: config.devmode ?? false,\n    collapseDynamicRoutes: config.collapseDynamicRoutes ?? true,\n    excludePages: config.excludePages,\n    includePages: config.includePages\n  };\n}\n\nfunction isGroupSegment(segment: string): boolean {\n  return /^\\(.+\\)$/.test(segment);\n}\n\nfunction collapsePath(segments: readonly string[]): string {\n  const visible = segments.filter(s => !isGroupSegment(s));\n  if (visible.length === 0) return '/';\n  return '/' + visible.join('/');\n}\n\nfunction useTrackedPath(config: InternalConfig): string {\n  const pathname = usePathname();\n  const segments = useSegments();\n  return config.collapseDynamicRoutes ? collapsePath(segments as readonly string[]) : pathname;\n}\n\nfunction isWebLocalhost(): boolean {\n  if (Platform.OS !== 'web') return false;\n  if (typeof window === 'undefined' || !window.location) return false;\n  const { hostname, protocol } = window.location;\n  return (\n    /^localhost$|^127(\\.[0-9]+){0,2}\\.[0-9]+$|^\\[::1?\\]$/.test(hostname) &&\n    (protocol === 'http:' || protocol === 'https:')\n  );\n}\n\nfunction useRequiredContext(caller: string): ContextValue {\n  const ctx = useContext(Context);\n  if (!ctx) {\n    throw new Error(\n      `[onedollarstats] ${caller} must be used inside <OneDollarStatsProvider>. ` +\n        `Wrap your root layout with the provider.`\n    );\n  }\n  return ctx;\n}\n\nexport type OneDollarStatsProviderProps = {\n  config: ExpoAnalyticsConfig;\n  children: ReactNode;\n};\n\nexport function OneDollarStatsProvider({ config, children }: OneDollarStatsProviderProps) {\n  const merged = useMemo(\n    () => mergeConfig(config),\n    [\n      config.hostname,\n      config.collectorUrl,\n      config.autocollect,\n      config.devmode,\n      config.collapseDynamicRoutes,\n      config.excludePages,\n      config.includePages\n    ]\n  );\n\n  const lastPathRef = useRef<string | null>(null);\n  // TODO(page-scope): restore when page-scope detection is designed.\n  // const overrideRef = useRef<Override>(null);\n  // const propsOverrideRef = useRef<PropsOverride>(null);\n  const announcedRef = useRef(false);\n  const trackedPath = useTrackedPath(merged);\n\n  useEffect(() => {\n    if (announcedRef.current) return;\n    if (merged.devmode && isWebLocalhost()) {\n      console.log(\n        `[onedollarstats]\\nOneDollarStats connected! Tracking localhost as ${merged.hostname}`\n      );\n    }\n    announcedRef.current = true;\n  }, [merged.devmode, merged.hostname]);\n\n  useEffect(() => {\n    if (!merged.autocollect) return;\n    if (isExcluded(trackedPath, merged)) return;\n    if (lastPathRef.current === trackedPath) return;\n    lastPathRef.current = trackedPath;\n    send('PageView', trackedPath, merged);\n  }, [trackedPath, merged]);\n\n  useEffect(() => {\n    const handler = (state: AppStateStatus) => {\n      if (state !== 'active') return;\n      if (!merged.autocollect) return;\n      const current = lastPathRef.current;\n      if (!current || isExcluded(current, merged)) return;\n      send('PageView', current, merged);\n    };\n    const sub = AppState.addEventListener('change', handler);\n    return () => sub.remove();\n  }, [merged]);\n\n  const value = useMemo<ContextValue>(\n    () => ({ config: merged, lastPathRef }),\n    [merged]\n  );\n\n  return createElement(Context.Provider, { value }, children);\n}\n\ntype Props = Record<string, string>;\n\nexport type AnalyticsAPI = {\n  event(eventName: string, pathOrProps?: string | Props, props?: Props): void;\n  view(pathOrProps?: string | Props, props?: Props): void;\n};\n\nexport function useAnalytics(): AnalyticsAPI {\n  const ctx = useRequiredContext('useAnalytics');\n  const trackedPath = useTrackedPath(ctx.config);\n\n  const event = useCallback(\n    (eventName: string, pathOrProps?: string | Props, props?: Props) => {\n      const targetPath = typeof pathOrProps === 'string' ? pathOrProps : trackedPath;\n      const eventProps = typeof pathOrProps === 'object' ? pathOrProps : props;\n      send(eventName, targetPath, ctx.config, eventProps);\n    },\n    [ctx, trackedPath]\n  );\n\n  const view = useCallback(\n    (pathOrProps?: string | Props, props?: Props) => {\n      const targetPath = typeof pathOrProps === 'string' ? pathOrProps : trackedPath;\n      const viewProps = typeof pathOrProps === 'object' ? pathOrProps : props;\n      send('PageView', targetPath, ctx.config, viewProps);\n    },\n    [ctx, trackedPath]\n  );\n\n  return { event, view };\n}\n\n// TODO(page-scope): restore when page-scope detection is designed.\n/*\nexport function useAnalyticsPath(customPath: string): void {\n  const ctx = useRequiredContext('useAnalyticsPath');\n  const pathname = usePathname();\n  useEffect(() => {\n    const entry: Override = { realPath: pathname, customPath, source: 'hook' };\n    ctx.overrideRef.current = entry;\n    return () => {\n      if (ctx.overrideRef.current === entry) ctx.overrideRef.current = null;\n    };\n  }, [ctx, pathname, customPath]);\n}\n\nexport type AnalyticsPathProps = { path: string };\n\nexport function AnalyticsPath({ path }: AnalyticsPathProps): null {\n  const ctx = useRequiredContext('AnalyticsPath');\n  const pathname = usePathname();\n  useEffect(() => {\n    const existing = ctx.overrideRef.current;\n    if (existing && existing.realPath === pathname && existing.source === 'hook') return;\n    const entry: Override = { realPath: pathname, customPath: path, source: 'component' };\n    ctx.overrideRef.current = entry;\n    return () => {\n      if (ctx.overrideRef.current === entry) ctx.overrideRef.current = null;\n    };\n  }, [ctx, pathname, path]);\n  return null;\n}\n\nexport function useAnalyticsProps(props: Record<string, string>): void {\n  const ctx = useRequiredContext('useAnalyticsProps');\n  const pathname = usePathname();\n  useEffect(() => {\n    const entry: PropsOverride = { realPath: pathname, props, source: 'hook' };\n    ctx.propsOverrideRef.current = entry;\n    return () => {\n      if (ctx.propsOverrideRef.current === entry) ctx.propsOverrideRef.current = null;\n    };\n  }, [ctx, pathname, props]);\n}\n\nexport type AnalyticsPropsProps = Record<string, string>;\n\nexport function AnalyticsProps(props: AnalyticsPropsProps): null {\n  const ctx = useRequiredContext('AnalyticsProps');\n  const pathname = usePathname();\n  useEffect(() => {\n    const existing = ctx.propsOverrideRef.current;\n    if (existing && existing.realPath === pathname && existing.source === 'hook') return;\n    const entry: PropsOverride = { realPath: pathname, props, source: 'component' };\n    ctx.propsOverrideRef.current = entry;\n    return () => {\n      if (ctx.propsOverrideRef.current === entry) ctx.propsOverrideRef.current = null;\n    };\n  }, [ctx, pathname, props]);\n  return null;\n}\n*/\n\nfunction shouldSkipSend(config: InternalConfig): boolean {\n  if (Platform.OS !== 'web') return false;\n  if (isWebLocalhost() && !config.devmode) return true;\n  return false;\n}\n\nfunction devLog(label: string, url: string, props?: Record<string, string>): void {\n  let msg = `[onedollarstats]\\nEvent name: ${label}\\nEvent collected from: ${url}`;\n  if (props && Object.keys(props).length > 0) {\n    msg += `\\nProps: ${JSON.stringify(props, null, 2)}`;\n  }\n  console.log(msg);\n}\n\nconst SAFE_GET_THRESHOLD = 1500;\n\nfunction send(\n  eventName: string,\n  path: string,\n  config: InternalConfig,\n  props?: Record<string, string>\n): void {\n  if (shouldSkipSend(config)) return;\n  const url = `https://${config.hostname}${path}`;\n  if (config.devmode) devLog(eventName, url, props);\n\n  const body = JSON.stringify({\n    u: url,\n    e: [{ t: eventName, ...(props && { p: props }) }]\n  });\n\n  if (Platform.OS === 'web') {\n    sendWeb(config.collectorUrl, body);\n  } else {\n    sendNative(config.collectorUrl, body);\n  }\n}\n\nfunction sendNative(collectorUrl: string, body: string): void {\n  fetch(collectorUrl, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body\n  }).catch(() => {});\n}\n\nfunction sendWeb(collectorUrl: string, body: string): void {\n  const bytes = new TextEncoder().encode(body);\n  const bin = String.fromCharCode(...bytes);\n  const payloadBase64 = btoa(bin);\n\n  if (payloadBase64.length <= SAFE_GET_THRESHOLD) {\n    const img = new Image(1, 1);\n    img.onerror = () => sendBeaconOrFetch(collectorUrl, body);\n    img.src = `${collectorUrl}?data=${payloadBase64}`;\n    return;\n  }\n\n  sendBeaconOrFetch(collectorUrl, body);\n}\n\nfunction sendBeaconOrFetch(collectorUrl: string, body: string): void {\n  if (typeof navigator !== 'undefined' && navigator.sendBeacon?.(collectorUrl, body)) {\n    return;\n  }\n\n  fetch(collectorUrl, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body,\n    keepalive: true\n  }).catch(() => {});\n}\n\nfunction pathMatches(path: string, prefix: string): boolean {\n  return path === prefix || path.startsWith(prefix.endsWith('/') ? prefix : prefix + '/');\n}\n\nfunction isExcluded(path: string, config: InternalConfig): boolean {\n  if (config.includePages?.length) {\n    return !config.includePages.some(p => pathMatches(path, p));\n  }\n  if (config.excludePages?.length) {\n    return config.excludePages.some(p => pathMatches(path, p));\n  }\n  return false;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "onedollarstats",
-  "version": "0.0.19",
+  "version": "0.0.21",
   "description": "A lightweight, zero-dependency analytics tracker for frontend apps",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -8,14 +8,23 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "default": "./dist/index.js"
+    },
+    "./expo": {
+      "types": "./dist/expo.d.ts",
+      "react-native": "./dist/expo.js",
+      "browser": "./dist/expo.js",
+      "default": "./dist/expo.js"
     }
   },
   "files": [
     "dist/index.js",
     "dist/index.js.map",
     "dist/index.d.ts",
-    "dist/types.d.ts"
+    "dist/types.d.ts",
+    "dist/expo.js",
+    "dist/expo.js.map",
+    "dist/expo.d.ts"
   ],
   "keywords": [
     "analytics",
@@ -29,29 +38,55 @@
   ],
   "author": "",
   "license": "MIT",
+  "peerDependencies": {
+    "expo-router": ">=3.0.0",
+    "react": ">=18.0.0",
+    "react-native": ">=0.73.0"
+  },
+  "peerDependenciesMeta": {
+    "expo-router": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "react-native": {
+      "optional": true
+    }
+  },
   "devDependencies": {
+    "@testing-library/react": "^14.0.0",
     "@types/jsdom": "^27.0.0",
+    "@types/react": "^18.0.0",
+    "@types/react-native": "^0.73.0",
     "esbuild": "^0.25.10",
+    "expo-router": "^3.0.0",
     "jsdom": "^26.0.0",
     "puppeteer": "^24.1.1",
+    "react": "^18.0.0",
+    "react-native": "^0.73.0",
     "tsx": "^4.19.2",
     "typescript": "^5.9.2",
     "vitest": "^4.0.18"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.build.json --emitDeclarationOnly && rm -rf dist/utils dist/script.d.ts dist/debug-modal.d.ts dist/globals.d.ts && esbuild src/index.ts --bundle --outfile=dist/index.js --platform=browser --format=esm --target=es2020 --sourcemap --legal-comments=none --define:DEBUG_SCRIPT_URL='\"https://assets.onedollarstats.com/stonks-debug.js\"'",
+    "build": "tsc -p tsconfig.build.json --emitDeclarationOnly && rm -rf dist/utils dist/script.d.ts dist/debug-modal.d.ts dist/globals.d.ts && esbuild src/index.ts --bundle --outfile=dist/index.js --platform=browser --format=esm --target=es2020 --sourcemap --legal-comments=none --define:DEBUG_SCRIPT_URL='\"https://assets.onedollarstats.com/stonks-debug.js\"' && esbuild src/expo.ts --bundle=false --outfile=dist/expo.js --platform=neutral --format=esm --target=es2020 --sourcemap --legal-comments=none",
     "bundle": "esbuild src/script.ts --bundle --minify --format=iife --outfile=build/stonks.js --legal-comments=none --define:DEBUG_SCRIPT_URL='\"https://assets.onedollarstats.com/stonks-debug.js\"'",
     "bundle:dev": "esbuild src/script.ts --bundle --minify --format=iife --outfile=build/stonks.js --legal-comments=none --define:DEBUG_SCRIPT_URL='\"https://assets.onedollarstats.com/stonks-debug-dev.js\"'",
     "bundle:test": "esbuild src/script.ts --bundle --format=cjs --outfile=build/stonks.js --legal-comments=none --define:DEBUG_SCRIPT_URL='\"https://assets.onedollarstats.com/stonks-debug.js\"'",
     "bundle:debug": "esbuild src/debug-modal.ts --bundle --minify --format=iife --outfile=build/stonks-debug.js --legal-comments=none",
     "test": "vitest run",
-    "test:units": "vitest run --project 'Unit Tests'",
-    "test:units:modal": "vitest run --project 'Unit Tests' src/utils/create-modal.test.ts",
-    "test:e2e:script": "vitest run --project 'Script E2E Tests'",
+    "test:unit": "vitest run --project 'Web Unit Tests' --project 'Expo Unit Tests'",
+    "test:unit:web": "vitest run --project 'Web Unit Tests'",
+    "test:unit:web:modal": "vitest run --project 'Web Unit Tests' src/utils/create-modal.test.ts",
+    "test:unit:expo": "vitest run --project 'Expo Unit Tests'",
+    "test:e2e": "vitest run --project 'Web E2E Tests' --project 'Package E2E Tests' --project 'Expo E2E Tests'",
+    "test:e2e:web": "vitest run --project 'Web E2E Tests'",
     "test:e2e:package": "vitest run --project 'Package E2E Tests'",
-    "test:e2e": "vitest run --project 'Script E2E Tests' --project 'Package E2E Tests'",
-    "test:build&e2e:script": "pnpm bundle:test && FORCE_BUILD=1 COPY_TRACKER=1 vitest run --project 'Script E2E Tests'",
-    "test:build&e2e:package": "pnpm build && FORCE_BUILD=1 COPY_PACKAGE=1 vitest run --project 'Package E2E Tests'",
+    "test:e2e:expo": "vitest run --project 'Expo E2E Tests'",
+    "test:build:e2e:web": "pnpm bundle:test && FORCE_BUILD=1 COPY_TRACKER=1 vitest run --project 'Web E2E Tests'",
+    "test:build:e2e:package": "pnpm build && FORCE_BUILD=1 COPY_PACKAGE=1 vitest run --project 'Package E2E Tests'",
+    "test:build:e2e:expo": "pnpm build && FORCE_BUILD=1 COPY_PACKAGE=1 vitest run --project 'Expo E2E Tests'",
     "test:all": "pnpm bundle:test && pnpm build && FORCE_BUILD=1 COPY_TRACKER=1 COPY_PACKAGE=1 vitest run"
   }
 }