@posthog/wizard 0.4.0 → 0.5.0

package/dist/src/nextjs/docs.js

@@ -27,6 +27,7 @@ export function PostHogProvider({ children }: { children: React.ReactNode }) {
       ui_host: "${(0, urls_1.getUiHostFromHost)(host)}",
       capture_pageview: false, // We capture pageviews manually
       capture_pageleave: true, // Enable pageleave capture
+      debug: process.env.NODE_ENV === "development",
     })
   }, [])
 
@@ -177,6 +178,7 @@ export default function App({ Component, pageProps }) {
       loaded: (posthog) => {
         if (process.env.NODE_ENV === "development") posthog.debug()
       },
+      debug: process.env.NODE_ENV === "development",
     })
 
     const handleRouteChange = () => posthog?.capture("$pageview")

package/dist/src/nextjs/docs.js.map

@@ -1 +1 @@
-{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../../src/nextjs/docs.ts"],"names":[],"mappings":";;;AAAA,wCAAwE;AAEjE,MAAM,sBAAsB,GAAG,CAAC,EACrC,IAAI,EACJ,QAAQ,GAIT,EAAE,EAAE;IACH,OAAO;;wBAGL,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KACtC;;;;;;;;;;;;;;;;;;;kBAmBgB,IAAA,wBAAiB,EAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eA4C1B,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;gBA2BxC,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;;;;;;;;;;;;aAY1C,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;wBAyBO,IAAA,2BAAoB,EAAC,IAAI,CAAC;;;;wBAI1B,IAAI;;;;wBAIJ,IAAI;;;;;;;;mDAQuB,CAAC;AACpD,CAAC,CAAC;AA3JW,QAAA,sBAAsB,0BA2JjC;AAEK,MAAM,wBAAwB,GAAG,CAAC,EACvC,IAAI,EACJ,QAAQ,GAIT,EAAE,EAAE;IACH,OAAO;;aAEI,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK;mCAElD,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KACtC;;;;;;;;;;;;;;;;;;kBAkBgB,IAAA,wBAAiB,EAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;gBAuBzB,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;;;;;;;;;;;;aAY1C,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;wBAyBO,IAAA,2BAAoB,EAAC,IAAI,CAAC;;;;wBAI1B,IAAI;;;;wBAIJ,IAAI;;;;;;;;mDAQuB,CAAC;AACpD,CAAC,CAAC;AA3GW,QAAA,wBAAwB,4BA2GnC","sourcesContent":["import { getAssetHostFromHost, getUiHostFromHost } from '../utils/urls';\n\nexport const getNextjsAppRouterDocs = ({\n  host,\n  language,\n}: {\n  host: string;\n  language: 'typescript' | 'javascript';\n}) => {\n  return `\n==============================\nFILE: PostHogProvider.${\n    language === 'typescript' ? 'tsx' : 'jsx'\n  } (put it somewhere where client files are, like the components folder)\nLOCATION: Wherever other providers are, or the components folder\n==============================\nChanges:\n- Create a PostHogProvider component that will be imported into the layout file.\n\nExample:\n--------------------------------------------------\n\"use client\"\n\nimport posthog from \"posthog-js\"\nimport { PostHogProvider as PHProvider, usePostHog } from \"posthog-js/react\"\nimport { Suspense, useEffect } from \"react\"\nimport { usePathname, useSearchParams } from \"next/navigation\"\n\nexport function PostHogProvider({ children }: { children: React.ReactNode }) {\n  useEffect(() => {\n    posthog.init(process.env.NEXT_PUBLIC_POSTHOG_KEY!, {\n      api_host: \"/ingest\",\n      ui_host: \"${getUiHostFromHost(host)}\",\n      capture_pageview: false, // We capture pageviews manually\n      capture_pageleave: true, // Enable pageleave capture\n    })\n  }, [])\n\n  return (\n    <PHProvider client={posthog}>\n      <SuspendedPostHogPageView />\n      {children}\n    </PHProvider>\n  )\n}\n\n\nfunction PostHogPageView() {\n  const pathname = usePathname()\n  const searchParams = useSearchParams()\n  const posthog = usePostHog()\n\n  useEffect(() => {\n    if (pathname && posthog) {\n      let url = window.origin + pathname\n      const search = searchParams.toString()\n      if (search) {\n        url += \"?\" + search\n      }\n      posthog.capture(\"$pageview\", { \"$current_url\": url })\n    }\n  }, [pathname, searchParams, posthog])\n\n  return null\n}\n\nfunction SuspendedPostHogPageView() {\n  return (\n    <Suspense fallback={null}>\n      <PostHogPageView />\n    </Suspense>\n  )\n}\n--------------------------------------------------\n\n==============================\nFILE: layout.${language === 'typescript' ? 'tsx' : 'jsx'}\nLOCATION: Wherever the root layout is\n==============================\nChanges:\n- Import the PostHogProvider from the providers file and wrap the app in it.\n\nExample:\n--------------------------------------------------\n// other imports\nimport { PostHogProvider } from \"LOCATION_OF_POSTHOG_PROVIDER\"\n\nexport default function RootLayout({ children }) {\n  return (\n    <html lang=\"en\">\n      <body>\n        <PostHogProvider>\n          {/* other providers */}\n          {children}\n          {/* other providers */}\n        </PostHogProvider>\n      </body>\n    </html>\n  )\n}\n--------------------------------------------------\n\n==============================\nFILE: posthog.${language === 'typescript' ? 'ts' : 'js'}\nLOCATION: Wherever works best given the project structure\n==============================\nChanges:\n- Initialize the PostHog Node.js client\n\nExample:\n--------------------------------------------------\nimport { PostHog } from \"posthog-node\"\n\nexport default function PostHogClient() {\n  const posthogClient = new PostHog(process.env.NEXT_PUBLIC_POSTHOG_KEY!, {\n    host: \"${host}\",\n    flushAt: 1,\n    flushInterval: 0,\n  })\n  return posthogClient\n}\n--------------------------------------------------\n\n==============================\nFILE: next.config.{js,ts,mjs,cjs}\nLOCATION: Wherever the root next config is\n==============================\nChanges:\n- Add rewrites to the Next.js config to support PostHog, if there are existing rewrites, add the PostHog rewrites to them.\n- Add skipTrailingSlashRedirect to the Next.js config to support PostHog trailing slash API requests.\n- This can be of type js, ts, mjs, cjs etc. You should adapt the file according to what extension it uses, and if it does not exist yet use '.js'.\n\nExample:\n--------------------------------------------------\nconst nextConfig = {\n  // other config\n  async rewrites() {\n    return [\n      {\n        source: \"/ingest/static/:path*\",\n        destination: \"${getAssetHostFromHost(host)}/static/:path*\",\n      },\n      {\n        source: \"/ingest/:path*\",\n        destination: \"${host}/:path*\",\n      },\n      {\n        source: \"/ingest/decide\",\n        destination: \"${host}/decide\",\n      },\n    ];\n  },\n  // This is required to support PostHog trailing slash API requests\n  skipTrailingSlashRedirect: true,\n}\nmodule.exports = nextConfig\n--------------------------------------------------`;\n};\n\nexport const getNextjsPagesRouterDocs = ({\n  host,\n  language,\n}: {\n  host: string;\n  language: 'typescript' | 'javascript';\n}) => {\n  return `\n==============================\nFILE: _app.${language === 'typescript' ? 'tsx' : 'jsx'}\nLOCATION: Wherever the root _app.${\n    language === 'typescript' ? 'tsx' : 'jsx'\n  } file is\n==============================\nChanges:\n- Initialize PostHog in _app.js.\n- Wrap the application in PostHogProvider.\n- Manually capture $pageview events.\n\nExample:\n--------------------------------------------------\nimport { useEffect } from \"react\"\nimport { Router } from \"next/router\"\nimport posthog from \"posthog-js\"\nimport { PostHogProvider } from \"posthog-js/react\"\n\nexport default function App({ Component, pageProps }) {\n  useEffect(() => {\n    posthog.init(process.env.NEXT_PUBLIC_POSTHOG_KEY, {\n      api_host: \"/ingest\",\n      ui_host: \"${getUiHostFromHost(host)}\",\n      loaded: (posthog) => {\n        if (process.env.NODE_ENV === \"development\") posthog.debug()\n      },\n    })\n\n    const handleRouteChange = () => posthog?.capture(\"$pageview\")\n    Router.events.on(\"routeChangeComplete\", handleRouteChange)\n\n    return () => {\n      Router.events.off(\"routeChangeComplete\", handleRouteChange)\n    }\n  }, [])\n\n  return (\n    <PostHogProvider client={posthog}>\n      <Component {...pageProps} />\n    </PostHogProvider>\n  )\n}\n--------------------------------------------------\n\n==============================\nFILE: posthog.${language === 'typescript' ? 'ts' : 'js'}\nLOCATION: Wherever works best given the project structure\n==============================\nChanges:\n- Initialize the PostHog Node.js client\n\nExample:\n--------------------------------------------------\nimport { PostHog } from \"posthog-node\"\n\nexport default function PostHogClient() {\n  const posthogClient = new PostHog(process.env.NEXT_PUBLIC_POSTHOG_KEY!, {\n    host: \"${host}\",\n    flushAt: 1,\n    flushInterval: 0,\n  })\n  return posthogClient\n}\n--------------------------------------------------\n\n==============================\nFILE: next.config.{js,ts,mjs,cjs}\nLOCATION: Wherever the root next config is\n==============================\nChanges:\n- Add rewrites to the Next.js config to support PostHog, if there are existing rewrites, add the PostHog rewrites to them.\n- Add skipTrailingSlashRedirect to the Next.js config to support PostHog trailing slash API requests.\n- This can be of type js, ts, mjs, cjs etc. You should adapt the file according to what extension it uses, and if it does not exist yet use '.js'.\n\nExample:\n--------------------------------------------------\nconst nextConfig = {\n  // other config\n  async rewrites() {\n    return [\n      {\n        source: \"/ingest/static/:path*\",\n        destination: \"${getAssetHostFromHost(host)}/static/:path*\",\n      },\n      {\n        source: \"/ingest/:path*\",\n        destination: \"${host}/:path*\",\n      },\n      {\n        source: \"/ingest/decide\",\n        destination: \"${host}/decide\",\n      },\n    ];\n  },\n  // This is required to support PostHog trailing slash API requests\n  skipTrailingSlashRedirect: true,\n}\nmodule.exports = nextConfig\n--------------------------------------------------`;\n};\n"]}
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../../src/nextjs/docs.ts"],"names":[],"mappings":";;;AAAA,wCAAwE;AAEjE,MAAM,sBAAsB,GAAG,CAAC,EACrC,IAAI,EACJ,QAAQ,GAIT,EAAE,EAAE;IACH,OAAO;;wBAGL,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KACtC;;;;;;;;;;;;;;;;;;;kBAmBgB,IAAA,wBAAiB,EAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eA6C1B,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;gBA2BxC,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;;;;;;;;;;;;aAY1C,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;wBAyBO,IAAA,2BAAoB,EAAC,IAAI,CAAC;;;;wBAI1B,IAAI;;;;wBAIJ,IAAI;;;;;;;;mDAQuB,CAAC;AACpD,CAAC,CAAC;AA5JW,QAAA,sBAAsB,0BA4JjC;AAEK,MAAM,wBAAwB,GAAG,CAAC,EACvC,IAAI,EACJ,QAAQ,GAIT,EAAE,EAAE;IACH,OAAO;;aAEI,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK;mCAElD,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KACtC;;;;;;;;;;;;;;;;;;kBAkBgB,IAAA,wBAAiB,EAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;gBAwBzB,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;;;;;;;;;;;;aAY1C,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;wBAyBO,IAAA,2BAAoB,EAAC,IAAI,CAAC;;;;wBAI1B,IAAI;;;;wBAIJ,IAAI;;;;;;;;mDAQuB,CAAC;AACpD,CAAC,CAAC;AA5GW,QAAA,wBAAwB,4BA4GnC","sourcesContent":["import { getAssetHostFromHost, getUiHostFromHost } from '../utils/urls';\n\nexport const getNextjsAppRouterDocs = ({\n  host,\n  language,\n}: {\n  host: string;\n  language: 'typescript' | 'javascript';\n}) => {\n  return `\n==============================\nFILE: PostHogProvider.${\n    language === 'typescript' ? 'tsx' : 'jsx'\n  } (put it somewhere where client files are, like the components folder)\nLOCATION: Wherever other providers are, or the components folder\n==============================\nChanges:\n- Create a PostHogProvider component that will be imported into the layout file.\n\nExample:\n--------------------------------------------------\n\"use client\"\n\nimport posthog from \"posthog-js\"\nimport { PostHogProvider as PHProvider, usePostHog } from \"posthog-js/react\"\nimport { Suspense, useEffect } from \"react\"\nimport { usePathname, useSearchParams } from \"next/navigation\"\n\nexport function PostHogProvider({ children }: { children: React.ReactNode }) {\n  useEffect(() => {\n    posthog.init(process.env.NEXT_PUBLIC_POSTHOG_KEY!, {\n      api_host: \"/ingest\",\n      ui_host: \"${getUiHostFromHost(host)}\",\n      capture_pageview: false, // We capture pageviews manually\n      capture_pageleave: true, // Enable pageleave capture\n      debug: process.env.NODE_ENV === \"development\",\n    })\n  }, [])\n\n  return (\n    <PHProvider client={posthog}>\n      <SuspendedPostHogPageView />\n      {children}\n    </PHProvider>\n  )\n}\n\n\nfunction PostHogPageView() {\n  const pathname = usePathname()\n  const searchParams = useSearchParams()\n  const posthog = usePostHog()\n\n  useEffect(() => {\n    if (pathname && posthog) {\n      let url = window.origin + pathname\n      const search = searchParams.toString()\n      if (search) {\n        url += \"?\" + search\n      }\n      posthog.capture(\"$pageview\", { \"$current_url\": url })\n    }\n  }, [pathname, searchParams, posthog])\n\n  return null\n}\n\nfunction SuspendedPostHogPageView() {\n  return (\n    <Suspense fallback={null}>\n      <PostHogPageView />\n    </Suspense>\n  )\n}\n--------------------------------------------------\n\n==============================\nFILE: layout.${language === 'typescript' ? 'tsx' : 'jsx'}\nLOCATION: Wherever the root layout is\n==============================\nChanges:\n- Import the PostHogProvider from the providers file and wrap the app in it.\n\nExample:\n--------------------------------------------------\n// other imports\nimport { PostHogProvider } from \"LOCATION_OF_POSTHOG_PROVIDER\"\n\nexport default function RootLayout({ children }) {\n  return (\n    <html lang=\"en\">\n      <body>\n        <PostHogProvider>\n          {/* other providers */}\n          {children}\n          {/* other providers */}\n        </PostHogProvider>\n      </body>\n    </html>\n  )\n}\n--------------------------------------------------\n\n==============================\nFILE: posthog.${language === 'typescript' ? 'ts' : 'js'}\nLOCATION: Wherever works best given the project structure\n==============================\nChanges:\n- Initialize the PostHog Node.js client\n\nExample:\n--------------------------------------------------\nimport { PostHog } from \"posthog-node\"\n\nexport default function PostHogClient() {\n  const posthogClient = new PostHog(process.env.NEXT_PUBLIC_POSTHOG_KEY!, {\n    host: \"${host}\",\n    flushAt: 1,\n    flushInterval: 0,\n  })\n  return posthogClient\n}\n--------------------------------------------------\n\n==============================\nFILE: next.config.{js,ts,mjs,cjs}\nLOCATION: Wherever the root next config is\n==============================\nChanges:\n- Add rewrites to the Next.js config to support PostHog, if there are existing rewrites, add the PostHog rewrites to them.\n- Add skipTrailingSlashRedirect to the Next.js config to support PostHog trailing slash API requests.\n- This can be of type js, ts, mjs, cjs etc. You should adapt the file according to what extension it uses, and if it does not exist yet use '.js'.\n\nExample:\n--------------------------------------------------\nconst nextConfig = {\n  // other config\n  async rewrites() {\n    return [\n      {\n        source: \"/ingest/static/:path*\",\n        destination: \"${getAssetHostFromHost(host)}/static/:path*\",\n      },\n      {\n        source: \"/ingest/:path*\",\n        destination: \"${host}/:path*\",\n      },\n      {\n        source: \"/ingest/decide\",\n        destination: \"${host}/decide\",\n      },\n    ];\n  },\n  // This is required to support PostHog trailing slash API requests\n  skipTrailingSlashRedirect: true,\n}\nmodule.exports = nextConfig\n--------------------------------------------------`;\n};\n\nexport const getNextjsPagesRouterDocs = ({\n  host,\n  language,\n}: {\n  host: string;\n  language: 'typescript' | 'javascript';\n}) => {\n  return `\n==============================\nFILE: _app.${language === 'typescript' ? 'tsx' : 'jsx'}\nLOCATION: Wherever the root _app.${\n    language === 'typescript' ? 'tsx' : 'jsx'\n  } file is\n==============================\nChanges:\n- Initialize PostHog in _app.js.\n- Wrap the application in PostHogProvider.\n- Manually capture $pageview events.\n\nExample:\n--------------------------------------------------\nimport { useEffect } from \"react\"\nimport { Router } from \"next/router\"\nimport posthog from \"posthog-js\"\nimport { PostHogProvider } from \"posthog-js/react\"\n\nexport default function App({ Component, pageProps }) {\n  useEffect(() => {\n    posthog.init(process.env.NEXT_PUBLIC_POSTHOG_KEY, {\n      api_host: \"/ingest\",\n      ui_host: \"${getUiHostFromHost(host)}\",\n      loaded: (posthog) => {\n        if (process.env.NODE_ENV === \"development\") posthog.debug()\n      },\n      debug: process.env.NODE_ENV === \"development\",\n    })\n\n    const handleRouteChange = () => posthog?.capture(\"$pageview\")\n    Router.events.on(\"routeChangeComplete\", handleRouteChange)\n\n    return () => {\n      Router.events.off(\"routeChangeComplete\", handleRouteChange)\n    }\n  }, [])\n\n  return (\n    <PostHogProvider client={posthog}>\n      <Component {...pageProps} />\n    </PostHogProvider>\n  )\n}\n--------------------------------------------------\n\n==============================\nFILE: posthog.${language === 'typescript' ? 'ts' : 'js'}\nLOCATION: Wherever works best given the project structure\n==============================\nChanges:\n- Initialize the PostHog Node.js client\n\nExample:\n--------------------------------------------------\nimport { PostHog } from \"posthog-node\"\n\nexport default function PostHogClient() {\n  const posthogClient = new PostHog(process.env.NEXT_PUBLIC_POSTHOG_KEY!, {\n    host: \"${host}\",\n    flushAt: 1,\n    flushInterval: 0,\n  })\n  return posthogClient\n}\n--------------------------------------------------\n\n==============================\nFILE: next.config.{js,ts,mjs,cjs}\nLOCATION: Wherever the root next config is\n==============================\nChanges:\n- Add rewrites to the Next.js config to support PostHog, if there are existing rewrites, add the PostHog rewrites to them.\n- Add skipTrailingSlashRedirect to the Next.js config to support PostHog trailing slash API requests.\n- This can be of type js, ts, mjs, cjs etc. You should adapt the file according to what extension it uses, and if it does not exist yet use '.js'.\n\nExample:\n--------------------------------------------------\nconst nextConfig = {\n  // other config\n  async rewrites() {\n    return [\n      {\n        source: \"/ingest/static/:path*\",\n        destination: \"${getAssetHostFromHost(host)}/static/:path*\",\n      },\n      {\n        source: \"/ingest/:path*\",\n        destination: \"${host}/:path*\",\n      },\n      {\n        source: \"/ingest/decide\",\n        destination: \"${host}/decide\",\n      },\n    ];\n  },\n  // This is required to support PostHog trailing slash API requests\n  skipTrailingSlashRedirect: true,\n}\nmodule.exports = nextConfig\n--------------------------------------------------`;\n};\n"]}

package/dist/src/nextjs/nextjs-wizard.js

@@ -16,6 +16,7 @@ const analytics_1 = require("../utils/analytics");
 const environment_1 = require("../utils/environment");
 const file_utils_1 = require("../utils/file-utils");
 const clack_utils_2 = require("../utils/clack-utils");
+const add_editor_rules_1 = require("../utils/rules/add-editor-rules");
 async function runNextjsWizard(options) {
     (0, clack_utils_1.printWelcome)({
         wizardName: 'PostHog Next.js Wizard',
@@ -94,8 +95,13 @@ async function runNextjsWizard(options) {
         installDir: options.installDir,
         integration: constants_1.Integration.nextjs,
     });
-    clack_1.default.outro(`
-${chalk_1.default.green('Successfully installed PostHog!')} ${`\n\n${aiConsent
+    await (0, add_editor_rules_1.addEditorRules)({
+        rulesName: 'next-rules.md',
+        installDir: options.installDir,
+        integration: constants_1.Integration.nextjs,
+        default: options.default,
+    });
+    clack_1.default.outro(`${chalk_1.default.green('Successfully installed PostHog!')} ${`\n\n${aiConsent
         ? `Note: This uses experimental AI to setup your project. It might have got it wrong, please check!\n`
         : ``}You should validate your setup by (re)starting your dev environment (e.g. ${chalk_1.default.cyan(`${packageManagerForOutro.runScriptCommand} dev`)})`}
 

package/dist/src/nextjs/nextjs-wizard.js.map

@@ -1 +1 @@
-{"version":3,"file":"nextjs-wizard.js","sourceRoot":"","sources":["../../../src/nextjs/nextjs-wizard.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable max-lines */\n\nimport chalk from 'chalk';\nimport {\n  abort,\n  askForAIConsent,\n  confirmContinueIfNoOrDirtyGitRepo,\n  ensurePackageIsInstalled,\n  getOrAskForProjectData,\n  getPackageDotJson,\n  getPackageManager,\n  installPackage,\n  isUsingTypeScript,\n  printWelcome,\n  runPrettierIfInstalled,\n} from '../utils/clack-utils';\nimport { getPackageVersion, hasPackageInstalled } from '../utils/package-json';\nimport {\n  getNextJsRouter,\n  getNextJsRouterName,\n  getNextJsVersionBucket,\n  NextJsRouter,\n} from './utils';\nimport clack from '../utils/clack';\nimport { Integration, ISSUES_URL } from '../lib/constants';\nimport { getNextjsAppRouterDocs, getNextjsPagesRouterDocs } from './docs';\nimport { analytics } from '../utils/analytics';\nimport { addOrUpdateEnvironmentVariables } from '../utils/environment';\nimport {\n  generateFileChangesForIntegration,\n  getFilesToChange,\n  getRelevantFilesForIntegration,\n} from '../utils/file-utils';\nimport type { WizardOptions } from '../utils/types';\nimport { askForCloudRegion } from '../utils/clack-utils';\n\nexport async function runNextjsWizard(options: WizardOptions): Promise<void> {\n  printWelcome({\n    wizardName: 'PostHog Next.js Wizard',\n  });\n\n  const aiConsent = await askForAIConsent(options);\n\n  if (!aiConsent) {\n    await abort(\n      'The Next.js wizard requires AI to get setup right now. Please view the docs to setup Next.js manually instead: https://posthog.com/docs/libraries/next-js',\n      0,\n    );\n  }\n\n  const cloudRegion = options.cloudRegion ?? (await askForCloudRegion());\n\n  const typeScriptDetected = isUsingTypeScript(options);\n\n  await confirmContinueIfNoOrDirtyGitRepo(options);\n\n  const packageJson = await getPackageDotJson(options);\n\n  await ensurePackageIsInstalled(packageJson, 'next', 'Next.js');\n\n  const nextVersion = getPackageVersion('next', packageJson);\n\n  analytics.setTag('nextjs-version', getNextJsVersionBucket(nextVersion));\n\n  const { projectApiKey, wizardHash, host } = await getOrAskForProjectData({\n    ...options,\n    cloudRegion,\n  });\n\n  const sdkAlreadyInstalled = hasPackageInstalled('posthog-js', packageJson);\n\n  analytics.setTag('sdk-already-installed', sdkAlreadyInstalled);\n\n  const { packageManager: packageManagerFromInstallStep } =\n    await installPackage({\n      packageName: 'posthog-js',\n      packageNameDisplayLabel: 'posthog-js',\n      alreadyInstalled: !!packageJson?.dependencies?.['posthog-js'],\n      forceInstall: options.forceInstall,\n      askBeforeUpdating: false,\n      installDir: options.installDir,\n      integration: Integration.nextjs,\n    });\n\n  await installPackage({\n    packageName: 'posthog-node',\n    packageNameDisplayLabel: 'posthog-node',\n    packageManager: packageManagerFromInstallStep,\n    alreadyInstalled: !!packageJson?.dependencies?.['posthog-node'],\n    forceInstall: options.forceInstall,\n    askBeforeUpdating: false,\n    installDir: options.installDir,\n    integration: Integration.nextjs,\n  });\n\n  const router = await getNextJsRouter(options);\n\n  const relevantFiles = await getRelevantFilesForIntegration({\n    installDir: options.installDir,\n    integration: Integration.nextjs,\n  });\n\n  const installationDocumentation = getInstallationDocumentation({\n    router,\n    host,\n    language: typeScriptDetected ? 'typescript' : 'javascript',\n  });\n\n  clack.log.info(\n    `Reviewing PostHog documentation for ${getNextJsRouterName(router)}`,\n  );\n\n  const filesToChange = await getFilesToChange({\n    integration: Integration.nextjs,\n    relevantFiles,\n    documentation: installationDocumentation,\n    wizardHash,\n    cloudRegion,\n  });\n\n  await generateFileChangesForIntegration({\n    integration: Integration.nextjs,\n    filesToChange,\n    wizardHash,\n    installDir: options.installDir,\n    documentation: installationDocumentation,\n    cloudRegion,\n  });\n\n  await addOrUpdateEnvironmentVariables({\n    variables: {\n      NEXT_PUBLIC_POSTHOG_KEY: projectApiKey,\n    },\n    installDir: options.installDir,\n    integration: Integration.nextjs,\n  });\n\n  const packageManagerForOutro =\n    packageManagerFromInstallStep ?? (await getPackageManager(options));\n\n  await runPrettierIfInstalled({\n    installDir: options.installDir,\n    integration: Integration.nextjs,\n  });\n\n  clack.outro(`\n${chalk.green('Successfully installed PostHog!')} ${`\\n\\n${\n    aiConsent\n      ? `Note: This uses experimental AI to setup your project. It might have got it wrong, please check!\\n`\n      : ``\n  }You should validate your setup by (re)starting your dev environment (e.g. ${chalk.cyan(\n    `${packageManagerForOutro.runScriptCommand} dev`,\n  )})`}\n\n${chalk.dim(`If you encounter any issues, let us know here: ${ISSUES_URL}`)}`);\n\n  await analytics.shutdown('success');\n}\n\nfunction getInstallationDocumentation({\n  router,\n  host,\n  language,\n}: {\n  router: NextJsRouter;\n  host: string;\n  language: 'typescript' | 'javascript';\n}) {\n  if (router === NextJsRouter.PAGES_ROUTER) {\n    return getNextjsPagesRouterDocs({ host, language });\n  }\n\n  return getNextjsAppRouterDocs({ host, language });\n}\n"]}
+{"version":3,"file":"nextjs-wizard.js","sourceRoot":"","sources":["../../../src/nextjs/nextjs-wizard.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable max-lines */\n\nimport chalk from 'chalk';\nimport {\n  abort,\n  askForAIConsent,\n  confirmContinueIfNoOrDirtyGitRepo,\n  ensurePackageIsInstalled,\n  getOrAskForProjectData,\n  getPackageDotJson,\n  getPackageManager,\n  installPackage,\n  isUsingTypeScript,\n  printWelcome,\n  runPrettierIfInstalled,\n} from '../utils/clack-utils';\nimport { getPackageVersion, hasPackageInstalled } from '../utils/package-json';\nimport {\n  getNextJsRouter,\n  getNextJsRouterName,\n  getNextJsVersionBucket,\n  NextJsRouter,\n} from './utils';\nimport clack from '../utils/clack';\nimport { Integration, ISSUES_URL } from '../lib/constants';\nimport { getNextjsAppRouterDocs, getNextjsPagesRouterDocs } from './docs';\nimport { analytics } from '../utils/analytics';\nimport { addOrUpdateEnvironmentVariables } from '../utils/environment';\nimport {\n  generateFileChangesForIntegration,\n  getFilesToChange,\n  getRelevantFilesForIntegration,\n} from '../utils/file-utils';\nimport type { WizardOptions } from '../utils/types';\nimport { askForCloudRegion } from '../utils/clack-utils';\nimport { addEditorRules } from '../utils/rules/add-editor-rules';\n\nexport async function runNextjsWizard(options: WizardOptions): Promise<void> {\n  printWelcome({\n    wizardName: 'PostHog Next.js Wizard',\n  });\n\n  const aiConsent = await askForAIConsent(options);\n\n  if (!aiConsent) {\n    await abort(\n      'The Next.js wizard requires AI to get setup right now. Please view the docs to setup Next.js manually instead: https://posthog.com/docs/libraries/next-js',\n      0,\n    );\n  }\n\n  const cloudRegion = options.cloudRegion ?? (await askForCloudRegion());\n\n  const typeScriptDetected = isUsingTypeScript(options);\n\n  await confirmContinueIfNoOrDirtyGitRepo(options);\n\n  const packageJson = await getPackageDotJson(options);\n\n  await ensurePackageIsInstalled(packageJson, 'next', 'Next.js');\n\n  const nextVersion = getPackageVersion('next', packageJson);\n\n  analytics.setTag('nextjs-version', getNextJsVersionBucket(nextVersion));\n\n  const { projectApiKey, wizardHash, host } = await getOrAskForProjectData({\n    ...options,\n    cloudRegion,\n  });\n\n  const sdkAlreadyInstalled = hasPackageInstalled('posthog-js', packageJson);\n\n  analytics.setTag('sdk-already-installed', sdkAlreadyInstalled);\n\n  const { packageManager: packageManagerFromInstallStep } =\n    await installPackage({\n      packageName: 'posthog-js',\n      packageNameDisplayLabel: 'posthog-js',\n      alreadyInstalled: !!packageJson?.dependencies?.['posthog-js'],\n      forceInstall: options.forceInstall,\n      askBeforeUpdating: false,\n      installDir: options.installDir,\n      integration: Integration.nextjs,\n    });\n\n  await installPackage({\n    packageName: 'posthog-node',\n    packageNameDisplayLabel: 'posthog-node',\n    packageManager: packageManagerFromInstallStep,\n    alreadyInstalled: !!packageJson?.dependencies?.['posthog-node'],\n    forceInstall: options.forceInstall,\n    askBeforeUpdating: false,\n    installDir: options.installDir,\n    integration: Integration.nextjs,\n  });\n\n  const router = await getNextJsRouter(options);\n\n  const relevantFiles = await getRelevantFilesForIntegration({\n    installDir: options.installDir,\n    integration: Integration.nextjs,\n  });\n\n  const installationDocumentation = getInstallationDocumentation({\n    router,\n    host,\n    language: typeScriptDetected ? 'typescript' : 'javascript',\n  });\n\n  clack.log.info(\n    `Reviewing PostHog documentation for ${getNextJsRouterName(router)}`,\n  );\n\n  const filesToChange = await getFilesToChange({\n    integration: Integration.nextjs,\n    relevantFiles,\n    documentation: installationDocumentation,\n    wizardHash,\n    cloudRegion,\n  });\n\n  await generateFileChangesForIntegration({\n    integration: Integration.nextjs,\n    filesToChange,\n    wizardHash,\n    installDir: options.installDir,\n    documentation: installationDocumentation,\n    cloudRegion,\n  });\n\n  await addOrUpdateEnvironmentVariables({\n    variables: {\n      NEXT_PUBLIC_POSTHOG_KEY: projectApiKey,\n    },\n    installDir: options.installDir,\n    integration: Integration.nextjs,\n  });\n\n  const packageManagerForOutro =\n    packageManagerFromInstallStep ?? (await getPackageManager(options));\n\n  await runPrettierIfInstalled({\n    installDir: options.installDir,\n    integration: Integration.nextjs,\n  });\n\n  await addEditorRules({\n    rulesName: 'next-rules.md',\n    installDir: options.installDir,\n    integration: Integration.nextjs,\n    default: options.default,\n  });\n\n  clack.outro(`${chalk.green('Successfully installed PostHog!')} ${`\\n\\n${\n    aiConsent\n      ? `Note: This uses experimental AI to setup your project. It might have got it wrong, please check!\\n`\n      : ``\n  }You should validate your setup by (re)starting your dev environment (e.g. ${chalk.cyan(\n    `${packageManagerForOutro.runScriptCommand} dev`,\n  )})`}\n\n${chalk.dim(`If you encounter any issues, let us know here: ${ISSUES_URL}`)}`);\n\n  await analytics.shutdown('success');\n}\n\nfunction getInstallationDocumentation({\n  router,\n  host,\n  language,\n}: {\n  router: NextJsRouter;\n  host: string;\n  language: 'typescript' | 'javascript';\n}) {\n  if (router === NextJsRouter.PAGES_ROUTER) {\n    return getNextjsPagesRouterDocs({ host, language });\n  }\n\n  return getNextjsAppRouterDocs({ host, language });\n}\n"]}

package/dist/src/react/docs.d.ts

@@ -1,4 +1,5 @@
-export declare const getReactDocumentation: ({ host, language, }: {
+export declare const getReactDocumentation: ({ host, language, envVarPrefix, }: {
     host: string;
     language: "typescript" | "javascript";
+    envVarPrefix: string;
 }) => string;

package/dist/src/react/docs.js

@@ -1,7 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getReactDocumentation = void 0;
-const getReactDocumentation = ({ host, language, }) => {
+const getReactDocumentation = ({ host, language, envVarPrefix, }) => {
+    const apiKeyText = envVarPrefix === 'VITE_PUBLIC_'
+        ? 'import.meta.env.VITE_PUBLIC_POSTHOG_KEY'
+        : `process.env.${envVarPrefix}POSTHOG_KEY`;
     return `
 ==============================
 FILE: {index / App}.${language === 'typescript' ? 'tsx' : 'jsx'} (wherever the root of the app is)
@@ -23,10 +26,13 @@ const root = ReactDOM.createRoot(document.getElementById('root'));
 root.render(
   <React.StrictMode>
     <PostHogProvider
-      apiKey={process.env.REACT_APP_PUBLIC_POSTHOG_KEY}
+      apiKey={${apiKeyText}}
       options={{
-  api_host: ${host},
-}}
+        api_host: ${host},
+        debug: ${envVarPrefix === 'VITE_PUBLIC_'
+        ? 'import.meta.env.MODE === "development"'
+        : 'process.env.NODE_ENV === "development"'},
+      }}
     >
       <App />
     </PostHogProvider>

package/dist/src/react/docs.js.map

@@ -1 +1 @@
-{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../../src/react/docs.ts"],"names":[],"mappings":";;;AAAO,MAAM,qBAAqB,GAAG,CAAC,EACpC,IAAI,EACJ,QAAQ,GAIT,EAAE,EAAE;IACH,OAAO;;sBAGL,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KACtC;;;;;;;;;;;;;;;;;;;;;cAqBY,IAAI;;;;;;mDAMiC,CAAC;AACpD,CAAC,CAAC;AAvCW,QAAA,qBAAqB,yBAuChC","sourcesContent":["export const getReactDocumentation = ({\n  host,\n  language,\n}: {\n  host: string;\n  language: 'typescript' | 'javascript';\n}) => {\n  return `\n==============================\nFILE: {index / App}.${\n    language === 'typescript' ? 'tsx' : 'jsx'\n  } (wherever the root of the app is)\nLOCATION: Wherever the root of the app is\n==============================\nChanges:\n- Add the PostHogProvider to the root of the app in the provider tree.\n\nExample:\n--------------------------------------------------\nimport React from 'react';\nimport ReactDOM from 'react-dom/client';\nimport App from './App';\n\nimport { PostHogProvider} from 'posthog-js/react'\n\nconst root = ReactDOM.createRoot(document.getElementById('root'));\n\nroot.render(\n  <React.StrictMode>\n    <PostHogProvider\n      apiKey={process.env.REACT_APP_PUBLIC_POSTHOG_KEY}\n      options={{\n  api_host: ${host},\n}}\n    >\n      <App />\n    </PostHogProvider>\n  </React.StrictMode>\n--------------------------------------------------`;\n};\n"]}
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../../src/react/docs.ts"],"names":[],"mappings":";;;AAAO,MAAM,qBAAqB,GAAG,CAAC,EACpC,IAAI,EACJ,QAAQ,EACR,YAAY,GAKb,EAAE,EAAE;IACH,MAAM,UAAU,GACd,YAAY,KAAK,cAAc;QAC7B,CAAC,CAAC,yCAAyC;QAC3C,CAAC,CAAC,eAAe,YAAY,aAAa,CAAC;IAC/C,OAAO;;sBAGL,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KACtC;;;;;;;;;;;;;;;;;;;gBAmBc,UAAU;;oBAEN,IAAI;iBAEd,YAAY,KAAK,cAAc;QAC7B,CAAC,CAAC,wCAAwC;QAC1C,CAAC,CAAC,wCACN;;;;;;mDAM2C,CAAC;AACpD,CAAC,CAAC;AAlDW,QAAA,qBAAqB,yBAkDhC","sourcesContent":["export const getReactDocumentation = ({\n  host,\n  language,\n  envVarPrefix,\n}: {\n  host: string;\n  language: 'typescript' | 'javascript';\n  envVarPrefix: string;\n}) => {\n  const apiKeyText =\n    envVarPrefix === 'VITE_PUBLIC_'\n      ? 'import.meta.env.VITE_PUBLIC_POSTHOG_KEY'\n      : `process.env.${envVarPrefix}POSTHOG_KEY`;\n  return `\n==============================\nFILE: {index / App}.${\n    language === 'typescript' ? 'tsx' : 'jsx'\n  } (wherever the root of the app is)\nLOCATION: Wherever the root of the app is\n==============================\nChanges:\n- Add the PostHogProvider to the root of the app in the provider tree.\n\nExample:\n--------------------------------------------------\nimport React from 'react';\nimport ReactDOM from 'react-dom/client';\nimport App from './App';\n\nimport { PostHogProvider} from 'posthog-js/react'\n\nconst root = ReactDOM.createRoot(document.getElementById('root'));\n\nroot.render(\n  <React.StrictMode>\n    <PostHogProvider\n      apiKey={${apiKeyText}}\n      options={{\n        api_host: ${host},\n        debug: ${\n          envVarPrefix === 'VITE_PUBLIC_'\n            ? 'import.meta.env.MODE === \"development\"'\n            : 'process.env.NODE_ENV === \"development\"'\n        },\n      }}\n    >\n      <App />\n    </PostHogProvider>\n  </React.StrictMode>\n--------------------------------------------------`;\n};\n"]}

package/dist/src/react/react-wizard.js

@@ -15,6 +15,7 @@ const analytics_1 = require("../utils/analytics");
 const environment_1 = require("../utils/environment");
 const file_utils_1 = require("../utils/file-utils");
 const clack_utils_2 = require("../utils/clack-utils");
+const add_editor_rules_1 = require("../utils/rules/add-editor-rules");
 async function runReactWizard(options) {
     (0, clack_utils_1.printWelcome)({
         wizardName: 'PostHog React Wizard',
@@ -51,9 +52,11 @@ async function runReactWizard(options) {
         installDir: options.installDir,
         integration: constants_1.Integration.react,
     });
+    const envVarPrefix = await (0, environment_1.detectEnvVarPrefix)(options);
     const installationDocumentation = (0, docs_1.getReactDocumentation)({
         host,
         language: typeScriptDetected ? 'typescript' : 'javascript',
+        envVarPrefix,
     });
     clack_1.default.log.info(`Reviewing PostHog documentation for React`);
     const filesToChange = await (0, file_utils_1.getFilesToChange)({
@@ -73,7 +76,7 @@ async function runReactWizard(options) {
     });
     await (0, environment_1.addOrUpdateEnvironmentVariables)({
         variables: {
-            REACT_APP_PUBLIC_POSTHOG_KEY: projectApiKey,
+            [envVarPrefix + 'POSTHOG_KEY']: projectApiKey,
         },
         installDir: options.installDir,
         integration: constants_1.Integration.react,
@@ -83,6 +86,12 @@ async function runReactWizard(options) {
         installDir: options.installDir,
         integration: constants_1.Integration.react,
     });
+    await (0, add_editor_rules_1.addEditorRules)({
+        installDir: options.installDir,
+        rulesName: 'react-rules.md',
+        integration: constants_1.Integration.react,
+        default: options.default,
+    });
     clack_1.default.outro(`
 ${chalk_1.default.green('Successfully installed PostHog!')} ${`\n\n${aiConsent
         ? `Note: This uses experimental AI to setup your project. It might have got it wrong, pleaes check!\n`

package/dist/src/react/react-wizard.js.map

@@ -1 +1 @@
-{"version":3,"file":"react-wizard.js","sourceRoot":"","sources":["../../../src/react/react-wizard.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable max-lines */\n\nimport chalk from 'chalk';\nimport {\n  abort,\n  askForAIConsent,\n  confirmContinueIfNoOrDirtyGitRepo,\n  ensurePackageIsInstalled,\n  getOrAskForProjectData,\n  getPackageDotJson,\n  getPackageManager,\n  installPackage,\n  isUsingTypeScript,\n  printWelcome,\n  runPrettierIfInstalled,\n} from '../utils/clack-utils';\nimport { getPackageVersion, hasPackageInstalled } from '../utils/package-json';\nimport clack from '../utils/clack';\nimport { Integration, ISSUES_URL } from '../lib/constants';\nimport { getReactDocumentation } from './docs';\nimport { analytics } from '../utils/analytics';\nimport { addOrUpdateEnvironmentVariables } from '../utils/environment';\nimport {\n  generateFileChangesForIntegration,\n  getFilesToChange,\n  getRelevantFilesForIntegration,\n} from '../utils/file-utils';\nimport type { WizardOptions } from '../utils/types';\nimport { askForCloudRegion } from '../utils/clack-utils';\n\nexport async function runReactWizard(options: WizardOptions): Promise<void> {\n  printWelcome({\n    wizardName: 'PostHog React Wizard',\n  });\n\n  const aiConsent = await askForAIConsent(options);\n\n  if (!aiConsent) {\n    await abort(\n      'The React wizard requires AI to get setup right now. Please view the docs to setup React manually instead: https://posthog.com/docs/libraries/react',\n      0,\n    );\n  }\n\n  const cloudRegion = options.cloudRegion ?? (await askForCloudRegion());\n\n  const typeScriptDetected = isUsingTypeScript(options);\n\n  await confirmContinueIfNoOrDirtyGitRepo(options);\n\n  const packageJson = await getPackageDotJson(options);\n\n  await ensurePackageIsInstalled(packageJson, 'react', 'React');\n\n  const reactVersion = getPackageVersion('react', packageJson);\n\n  if (reactVersion) {\n    analytics.setTag('react-version', reactVersion);\n  }\n\n  const { projectApiKey, wizardHash, host } = await getOrAskForProjectData({\n    ...options,\n    cloudRegion,\n  });\n\n  const sdkAlreadyInstalled = hasPackageInstalled('posthog-js', packageJson);\n\n  analytics.setTag('sdk-already-installed', sdkAlreadyInstalled);\n\n  const { packageManager: packageManagerFromInstallStep } =\n    await installPackage({\n      packageName: 'posthog-js',\n      packageNameDisplayLabel: 'posthog-js',\n      alreadyInstalled: !!packageJson?.dependencies?.['posthog-js'],\n      forceInstall: options.forceInstall,\n      askBeforeUpdating: false,\n      installDir: options.installDir,\n      integration: Integration.react,\n    });\n\n  const relevantFiles = await getRelevantFilesForIntegration({\n    installDir: options.installDir,\n    integration: Integration.react,\n  });\n\n  const installationDocumentation = getReactDocumentation({\n    host,\n    language: typeScriptDetected ? 'typescript' : 'javascript',\n  });\n\n  clack.log.info(`Reviewing PostHog documentation for React`);\n\n  const filesToChange = await getFilesToChange({\n    integration: Integration.react,\n    relevantFiles,\n    documentation: installationDocumentation,\n    wizardHash,\n    cloudRegion,\n  });\n\n  await generateFileChangesForIntegration({\n    integration: Integration.react,\n    filesToChange,\n    wizardHash,\n    installDir: options.installDir,\n    documentation: installationDocumentation,\n    cloudRegion,\n  });\n\n  await addOrUpdateEnvironmentVariables({\n    variables: {\n      REACT_APP_PUBLIC_POSTHOG_KEY: projectApiKey,\n    },\n    installDir: options.installDir,\n    integration: Integration.react,\n  });\n\n  const packageManagerForOutro =\n    packageManagerFromInstallStep ?? (await getPackageManager(options));\n\n  await runPrettierIfInstalled({\n    installDir: options.installDir,\n    integration: Integration.react,\n  });\n\n  clack.outro(`\n${chalk.green('Successfully installed PostHog!')} ${`\\n\\n${\n    aiConsent\n      ? `Note: This uses experimental AI to setup your project. It might have got it wrong, pleaes check!\\n`\n      : ``\n  }You should validate your setup by (re)starting your dev environment (e.g. ${chalk.cyan(\n    `${packageManagerForOutro.runScriptCommand} dev`,\n  )})`}\n\n${chalk.dim(`If you encounter any issues, let us know here: ${ISSUES_URL}`)}`);\n\n  await analytics.shutdown('success');\n}\n"]}
+{"version":3,"file":"react-wizard.js","sourceRoot":"","sources":["../../../src/react/react-wizard.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable max-lines */\n\nimport chalk from 'chalk';\nimport {\n  abort,\n  askForAIConsent,\n  confirmContinueIfNoOrDirtyGitRepo,\n  ensurePackageIsInstalled,\n  getOrAskForProjectData,\n  getPackageDotJson,\n  getPackageManager,\n  installPackage,\n  isUsingTypeScript,\n  printWelcome,\n  runPrettierIfInstalled,\n} from '../utils/clack-utils';\nimport { getPackageVersion, hasPackageInstalled } from '../utils/package-json';\nimport clack from '../utils/clack';\nimport { Integration, ISSUES_URL } from '../lib/constants';\nimport { getReactDocumentation } from './docs';\nimport { analytics } from '../utils/analytics';\nimport {\n  addOrUpdateEnvironmentVariables,\n  detectEnvVarPrefix,\n} from '../utils/environment';\nimport {\n  generateFileChangesForIntegration,\n  getFilesToChange,\n  getRelevantFilesForIntegration,\n} from '../utils/file-utils';\nimport type { WizardOptions } from '../utils/types';\nimport { askForCloudRegion } from '../utils/clack-utils';\nimport { addEditorRules } from '../utils/rules/add-editor-rules';\n\nexport async function runReactWizard(options: WizardOptions): Promise<void> {\n  printWelcome({\n    wizardName: 'PostHog React Wizard',\n  });\n\n  const aiConsent = await askForAIConsent(options);\n\n  if (!aiConsent) {\n    await abort(\n      'The React wizard requires AI to get setup right now. Please view the docs to setup React manually instead: https://posthog.com/docs/libraries/react',\n      0,\n    );\n  }\n\n  const cloudRegion = options.cloudRegion ?? (await askForCloudRegion());\n\n  const typeScriptDetected = isUsingTypeScript(options);\n\n  await confirmContinueIfNoOrDirtyGitRepo(options);\n\n  const packageJson = await getPackageDotJson(options);\n\n  await ensurePackageIsInstalled(packageJson, 'react', 'React');\n\n  const reactVersion = getPackageVersion('react', packageJson);\n\n  if (reactVersion) {\n    analytics.setTag('react-version', reactVersion);\n  }\n\n  const { projectApiKey, wizardHash, host } = await getOrAskForProjectData({\n    ...options,\n    cloudRegion,\n  });\n\n  const sdkAlreadyInstalled = hasPackageInstalled('posthog-js', packageJson);\n\n  analytics.setTag('sdk-already-installed', sdkAlreadyInstalled);\n\n  const { packageManager: packageManagerFromInstallStep } =\n    await installPackage({\n      packageName: 'posthog-js',\n      packageNameDisplayLabel: 'posthog-js',\n      alreadyInstalled: !!packageJson?.dependencies?.['posthog-js'],\n      forceInstall: options.forceInstall,\n      askBeforeUpdating: false,\n      installDir: options.installDir,\n      integration: Integration.react,\n    });\n\n  const relevantFiles = await getRelevantFilesForIntegration({\n    installDir: options.installDir,\n    integration: Integration.react,\n  });\n\n  const envVarPrefix = await detectEnvVarPrefix(options);\n\n  const installationDocumentation = getReactDocumentation({\n    host,\n    language: typeScriptDetected ? 'typescript' : 'javascript',\n    envVarPrefix,\n  });\n\n  clack.log.info(`Reviewing PostHog documentation for React`);\n\n  const filesToChange = await getFilesToChange({\n    integration: Integration.react,\n    relevantFiles,\n    documentation: installationDocumentation,\n    wizardHash,\n    cloudRegion,\n  });\n\n  await generateFileChangesForIntegration({\n    integration: Integration.react,\n    filesToChange,\n    wizardHash,\n    installDir: options.installDir,\n    documentation: installationDocumentation,\n    cloudRegion,\n  });\n\n  await addOrUpdateEnvironmentVariables({\n    variables: {\n      [envVarPrefix + 'POSTHOG_KEY']: projectApiKey,\n    },\n    installDir: options.installDir,\n    integration: Integration.react,\n  });\n\n  const packageManagerForOutro =\n    packageManagerFromInstallStep ?? (await getPackageManager(options));\n\n  await runPrettierIfInstalled({\n    installDir: options.installDir,\n    integration: Integration.react,\n  });\n\n  await addEditorRules({\n    installDir: options.installDir,\n    rulesName: 'react-rules.md',\n    integration: Integration.react,\n    default: options.default,\n  });\n\n  clack.outro(`\n${chalk.green('Successfully installed PostHog!')} ${`\\n\\n${\n    aiConsent\n      ? `Note: This uses experimental AI to setup your project. It might have got it wrong, pleaes check!\\n`\n      : ``\n  }You should validate your setup by (re)starting your dev environment (e.g. ${chalk.cyan(\n    `${packageManagerForOutro.runScriptCommand} dev`,\n  )})`}\n\n${chalk.dim(`If you encounter any issues, let us know here: ${ISSUES_URL}`)}`);\n\n  await analytics.shutdown('success');\n}\n"]}

package/dist/src/run.js

@@ -12,6 +12,7 @@ const clack_1 = __importDefault(require("./utils/clack"));
 const path_1 = __importDefault(require("path"));
 const config_1 = require("./lib/config");
 const react_wizard_1 = require("./react/react-wizard");
+const analytics_1 = require("./utils/analytics");
 async function run(argv) {
     await runWizard(argv);
 }
@@ -31,6 +32,7 @@ async function runWizard(argv) {
     };
     clack_1.default.intro(`Welcome to the PostHog setup wizard ✨`);
     const integration = finalArgs.integration ?? (await getIntegrationForSetup(wizardOptions));
+    analytics_1.analytics.setTag('integration', integration);
     switch (integration) {
         case constants_1.Integration.nextjs:
             await (0, nextjs_wizard_1.runNextjsWizard)(wizardOptions);

package/dist/src/run.js.map

@@ -1 +1 @@
-{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/run.ts"],"names":[],"mappings":";;;;;AAqBA,kBAEC;AAvBD,qDAAuD;AAEvD,0DAAyD;AAGzD,+CAAyE;AACzE,qDAAsD;AACtD,0DAAkC;AAClC,gDAAwB;AACxB,yCAAqE;AACrE,uDAAsD;AAW/C,KAAK,UAAU,GAAG,CAAC,IAAU;IAClC,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAU;IACjC,MAAM,SAAS,GAAG;QAChB,GAAG,IAAI;QACP,GAAG,IAAA,6BAAe,GAAE;KACrB,CAAC;IAEF,MAAM,aAAa,GAAkB;QACnC,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,KAAK;QAC/B,YAAY,EAAE,SAAS,CAAC,YAAY,IAAI,KAAK;QAC7C,UAAU,EAAE,SAAS,CAAC,UAAU;YAC9B,CAAC,CAAC,cAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,UAAU,CAAC;YAChD,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;QACjB,WAAW,EAAE,SAAS,CAAC,MAAM,IAAI,SAAS;QAC1C,OAAO,EAAE,SAAS,CAAC,OAAO,IAAI,KAAK;KACpC,CAAC;IAEF,eAAK,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAErD,MAAM,WAAW,GACf,SAAS,CAAC,WAAW,IAAI,CAAC,MAAM,sBAAsB,CAAC,aAAa,CAAC,CAAC,CAAC;IAEzE,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,uBAAW,CAAC,MAAM;YACrB,MAAM,IAAA,+BAAe,EAAC,aAAa,CAAC,CAAC;YACrC,MAAM;QACR,KAAK,uBAAW,CAAC,KAAK;YACpB,MAAM,IAAA,6BAAc,EAAC,aAAa,CAAC,CAAC;YACpC,MAAM;QAER;YACE,eAAK,CAAC,GAAG,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;IACjD,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,OAA0C;IAE1C,MAAM,kBAAkB,GAAG,MAAM,CAAC,OAAO,CAAC,2BAAkB,CAAC,CAAC,IAAI,CAChE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CACX,0BAAiB,CAAC,OAAO,CAAC,CAAgB,CAAC;QAC3C,0BAAiB,CAAC,OAAO,CAAC,CAAgB,CAAC,CAC9C,CAAC;IAEF,KAAK,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,kBAAkB,EAAE,CAAC;QACvD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,WAA0B,CAAC;QACpC,CAAC;IACH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,sBAAsB,CACnC,OAA0C;IAE1C,MAAM,mBAAmB,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAE7D,IAAI,mBAAmB,EAAE,CAAC;QACxB,eAAK,CAAC,GAAG,CAAC,OAAO,CACf,yBAAyB,IAAA,qCAAyB,EAAC,mBAAmB,CAAC,EAAE,CAC1E,CAAC;QACF,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,MAAM,WAAW,GAAgB,MAAM,IAAA,8BAAgB,EACrD,eAAK,CAAC,MAAM,CAAC;QACX,OAAO,EAAE,6BAA6B;QACtC,OAAO,EAAE;YACP,EAAE,KAAK,EAAE,uBAAW,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE;YAC/C,EAAE,KAAK,EAAE,uBAAW,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE;SAC7C;KACF,CAAC,CACH,CAAC;IAEF,OAAO,WAAW,CAAC;AACrB,CAAC","sourcesContent":["import { abortIfCancelled } from './utils/clack-utils';\n\nimport { runNextjsWizard } from './nextjs/nextjs-wizard';\nimport type { CloudRegion, WizardOptions } from './utils/types';\n\nimport { getIntegrationDescription, Integration } from './lib/constants';\nimport { readEnvironment } from './utils/environment';\nimport clack from './utils/clack';\nimport path from 'path';\nimport { INTEGRATION_CONFIG, INTEGRATION_ORDER } from './lib/config';\nimport { runReactWizard } from './react/react-wizard';\n\ntype Args = {\n  integration?: Integration;\n  debug?: boolean;\n  forceInstall?: boolean;\n  installDir?: string;\n  region?: CloudRegion;\n  default?: boolean;\n};\n\nexport async function run(argv: Args) {\n  await runWizard(argv);\n}\n\nasync function runWizard(argv: Args) {\n  const finalArgs = {\n    ...argv,\n    ...readEnvironment(),\n  };\n\n  const wizardOptions: WizardOptions = {\n    debug: finalArgs.debug ?? false,\n    forceInstall: finalArgs.forceInstall ?? false,\n    installDir: finalArgs.installDir\n      ? path.join(process.cwd(), finalArgs.installDir)\n      : process.cwd(),\n    cloudRegion: finalArgs.region ?? undefined,\n    default: finalArgs.default ?? false,\n  };\n\n  clack.intro(`Welcome to the PostHog setup wizard ✨`);\n\n  const integration =\n    finalArgs.integration ?? (await getIntegrationForSetup(wizardOptions));\n\n  switch (integration) {\n    case Integration.nextjs:\n      await runNextjsWizard(wizardOptions);\n      break;\n    case Integration.react:\n      await runReactWizard(wizardOptions);\n      break;\n\n    default:\n      clack.log.error('No setup wizard selected!');\n  }\n}\n\nasync function detectIntegration(\n  options: Pick<WizardOptions, 'installDir'>,\n): Promise<Integration | undefined> {\n  const integrationConfigs = Object.entries(INTEGRATION_CONFIG).sort(\n    ([a], [b]) =>\n      INTEGRATION_ORDER.indexOf(a as Integration) -\n      INTEGRATION_ORDER.indexOf(b as Integration),\n  );\n\n  for (const [integration, config] of integrationConfigs) {\n    const detected = await config.detect(options);\n    if (detected) {\n      return integration as Integration;\n    }\n  }\n}\n\nasync function getIntegrationForSetup(\n  options: Pick<WizardOptions, 'installDir'>,\n) {\n  const detectedIntegration = await detectIntegration(options);\n\n  if (detectedIntegration) {\n    clack.log.success(\n      `Detected integration: ${getIntegrationDescription(detectedIntegration)}`,\n    );\n    return detectedIntegration;\n  }\n\n  const integration: Integration = await abortIfCancelled(\n    clack.select({\n      message: 'What do you want to set up?',\n      options: [\n        { value: Integration.nextjs, label: 'Next.js' },\n        { value: Integration.react, label: 'React' },\n      ],\n    }),\n  );\n\n  return integration;\n}\n"]}
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/run.ts"],"names":[],"mappings":"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","sourcesContent":["import { abortIfCancelled } from './utils/clack-utils';\n\nimport { runNextjsWizard } from './nextjs/nextjs-wizard';\nimport type { CloudRegion, WizardOptions } from './utils/types';\n\nimport { getIntegrationDescription, Integration } from './lib/constants';\nimport { readEnvironment } from './utils/environment';\nimport clack from './utils/clack';\nimport path from 'path';\nimport { INTEGRATION_CONFIG, INTEGRATION_ORDER } from './lib/config';\nimport { runReactWizard } from './react/react-wizard';\nimport { analytics } from './utils/analytics';\n\ntype Args = {\n  integration?: Integration;\n  debug?: boolean;\n  forceInstall?: boolean;\n  installDir?: string;\n  region?: CloudRegion;\n  default?: boolean;\n};\n\nexport async function run(argv: Args) {\n  await runWizard(argv);\n}\n\nasync function runWizard(argv: Args) {\n  const finalArgs = {\n    ...argv,\n    ...readEnvironment(),\n  };\n\n  const wizardOptions: WizardOptions = {\n    debug: finalArgs.debug ?? false,\n    forceInstall: finalArgs.forceInstall ?? false,\n    installDir: finalArgs.installDir\n      ? path.join(process.cwd(), finalArgs.installDir)\n      : process.cwd(),\n    cloudRegion: finalArgs.region ?? undefined,\n    default: finalArgs.default ?? false,\n  };\n\n  clack.intro(`Welcome to the PostHog setup wizard ✨`);\n\n  const integration =\n    finalArgs.integration ?? (await getIntegrationForSetup(wizardOptions));\n\n  analytics.setTag('integration', integration);\n\n  switch (integration) {\n    case Integration.nextjs:\n      await runNextjsWizard(wizardOptions);\n      break;\n    case Integration.react:\n      await runReactWizard(wizardOptions);\n      break;\n\n    default:\n      clack.log.error('No setup wizard selected!');\n  }\n}\n\nasync function detectIntegration(\n  options: Pick<WizardOptions, 'installDir'>,\n): Promise<Integration | undefined> {\n  const integrationConfigs = Object.entries(INTEGRATION_CONFIG).sort(\n    ([a], [b]) =>\n      INTEGRATION_ORDER.indexOf(a as Integration) -\n      INTEGRATION_ORDER.indexOf(b as Integration),\n  );\n\n  for (const [integration, config] of integrationConfigs) {\n    const detected = await config.detect(options);\n    if (detected) {\n      return integration as Integration;\n    }\n  }\n}\n\nasync function getIntegrationForSetup(\n  options: Pick<WizardOptions, 'installDir'>,\n) {\n  const detectedIntegration = await detectIntegration(options);\n\n  if (detectedIntegration) {\n    clack.log.success(\n      `Detected integration: ${getIntegrationDescription(detectedIntegration)}`,\n    );\n    return detectedIntegration;\n  }\n\n  const integration: Integration = await abortIfCancelled(\n    clack.select({\n      message: 'What do you want to set up?',\n      options: [\n        { value: Integration.nextjs, label: 'Next.js' },\n        { value: Integration.react, label: 'React' },\n      ],\n    }),\n  );\n\n  return integration;\n}\n"]}

package/dist/src/utils/environment.d.ts

@@ -1,7 +1,9 @@
 import { Integration } from '../lib/constants';
+import type { WizardOptions } from './types';
 export declare function readEnvironment(): Record<string, unknown>;
 export declare function addOrUpdateEnvironmentVariables({ installDir, variables, integration, }: {
     installDir: string;
     variables: Record<string, string>;
     integration: Integration;
 }): Promise<void>;
+export declare function detectEnvVarPrefix(options: WizardOptions): Promise<string>;

package/dist/src/utils/environment.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.readEnvironment = readEnvironment;
 exports.addOrUpdateEnvironmentVariables = addOrUpdateEnvironmentVariables;
+exports.detectEnvVarPrefix = detectEnvVarPrefix;
 const path_1 = __importDefault(require("path"));
 const read_env_1 = __importDefault(require("read-env"));
 const fs_1 = __importDefault(require("fs"));
@@ -12,6 +13,8 @@ const clack_1 = __importDefault(require("./clack"));
 const chalk_1 = __importDefault(require("chalk"));
 const file_utils_1 = require("./file-utils");
 const analytics_1 = require("./analytics");
+const clack_utils_1 = require("./clack-utils");
+const fast_glob_1 = __importDefault(require("fast-glob"));
 function readEnvironment() {
     const result = (0, read_env_1.default)('POSTHOG_WIZARD');
     return result;
@@ -109,4 +112,53 @@ async function addOrUpdateEnvironmentVariables({ installDir, variables, integrat
         integration,
     });
 }
+async function detectEnvVarPrefix(options) {
+    const packageJson = await (0, clack_utils_1.getPackageDotJson)(options);
+    const deps = { ...packageJson.dependencies, ...packageJson.devDependencies };
+    const has = (name) => name in deps;
+    const hasAnyFile = async (patterns) => {
+        const matches = await (0, fast_glob_1.default)(patterns, {
+            cwd: options.installDir,
+            absolute: false,
+            onlyFiles: true,
+            ignore: ['**/node_modules/**'],
+        });
+        return matches.length > 0;
+    };
+    // --- Next.js
+    if (has('next') || (await hasAnyFile(['**/next.config.{js,ts,mjs,cjs}']))) {
+        return 'NEXT_PUBLIC_';
+    }
+    // --- Create React App
+    if (has('react-scripts') ||
+        has('create-react-app') ||
+        (await hasAnyFile(['**/config-overrides.js']))) {
+        return 'REACT_APP_';
+    }
+    // --- Vite (vanilla, TanStack, Solid, etc.)
+    // Note: Vite does not need PUBLIC_ but we use it to follow the docs, to improve the chances of an LLM getting it right.
+    if (has('vite') || (await hasAnyFile(['**/vite.config.{js,ts,mjs,cjs}']))) {
+        return 'VITE_PUBLIC_';
+    }
+    // --- SvelteKit
+    if (has('@sveltejs/kit') ||
+        (await hasAnyFile(['**/svelte.config.{js,ts}']))) {
+        return 'PUBLIC_';
+    }
+    // --- TanStack Start (uses Vite)
+    if (has('@tanstack/start') ||
+        (await hasAnyFile(['**/tanstack.config.{js,ts}']))) {
+        return 'VITE_PUBLIC_';
+    }
+    // --- SolidStart (uses Vite)
+    if (has('solid-start') || (await hasAnyFile(['**/solid.config.{js,ts}']))) {
+        return 'VITE_PUBLIC_';
+    }
+    // --- Astro
+    if (has('astro') || (await hasAnyFile(['**/astro.config.{js,ts,mjs}']))) {
+        return 'PUBLIC_';
+    }
+    // We default to Vite if we can't detect a specific framework, since it's the most commonly used.
+    return 'VITE_PUBLIC_';
+}
 //# sourceMappingURL=environment.js.map

package/dist/src/utils/environment.js.map

@@ -1 +1 @@
-{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../../src/utils/environment.ts"],"names":[],"mappings":"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","sourcesContent":["import path from 'path';\nimport readEnv from 'read-env';\nimport fs from 'fs';\nimport clack from './clack';\nimport chalk from 'chalk';\nimport { getDotGitignore } from './file-utils';\nimport { Integration } from '../lib/constants';\nimport { analytics } from './analytics';\nexport function readEnvironment(): Record<string, unknown> {\n  const result = readEnv('POSTHOG_WIZARD');\n\n  return result;\n}\n\nexport async function addOrUpdateEnvironmentVariables({\n  installDir,\n  variables,\n  integration,\n}: {\n  installDir: string;\n  variables: Record<string, string>;\n  integration: Integration;\n}): Promise<void> {\n  const envVarContent = Object.entries(variables)\n    .map(([key, value]) => `${key}=${value}`)\n    .join('\\n');\n\n  const dotEnvLocalFilePath = path.join(installDir, '.env.local');\n  const dotEnvFilePath = path.join(installDir, '.env');\n  const targetEnvFilePath = fs.existsSync(dotEnvLocalFilePath)\n    ? dotEnvLocalFilePath\n    : dotEnvFilePath;\n\n  const dotEnvFileExists = fs.existsSync(targetEnvFilePath);\n\n  const relativeEnvFilePath = path.relative(installDir, targetEnvFilePath);\n\n  if (dotEnvFileExists) {\n    try {\n      let dotEnvFileContent = fs.readFileSync(targetEnvFilePath, 'utf8');\n      let updated = false;\n\n      for (const [key, value] of Object.entries(variables)) {\n        const regex = new RegExp(`^${key}=.*$`, 'm');\n\n        if (dotEnvFileContent.match(regex)) {\n          dotEnvFileContent = dotEnvFileContent.replace(\n            regex,\n            `${key}=${value}`,\n          );\n          updated = true;\n        } else {\n          if (!dotEnvFileContent.endsWith('\\n')) {\n            dotEnvFileContent += '\\n';\n          }\n          dotEnvFileContent += `${key}=${value}\\n`;\n          updated = true;\n        }\n      }\n\n      if (updated) {\n        await fs.promises.writeFile(targetEnvFilePath, dotEnvFileContent, {\n          encoding: 'utf8',\n          flag: 'w',\n        });\n        clack.log.success(\n          `Updated environment variables in ${chalk.bold.cyan(\n            relativeEnvFilePath,\n          )}`,\n        );\n      } else {\n        clack.log.success(\n          `${chalk.bold.cyan(\n            relativeEnvFilePath,\n          )} already has the necessary environment variables.`,\n        );\n      }\n    } catch (error) {\n      clack.log.warning(\n        `Failed to update environment variables in ${chalk.bold.cyan(\n          relativeEnvFilePath,\n        )}. Please update them manually. Error: ${error.message}`,\n      );\n    }\n  } else {\n    try {\n      await fs.promises.writeFile(targetEnvFilePath, envVarContent, {\n        encoding: 'utf8',\n        flag: 'w',\n      });\n      clack.log.success(\n        `Created ${chalk.bold.cyan(\n          relativeEnvFilePath,\n        )} with environment variables.`,\n      );\n    } catch (error) {\n      clack.log.warning(\n        `Failed to create ${chalk.bold.cyan(\n          relativeEnvFilePath,\n        )} with environment variables. Please add them manually. Error: ${\n          error.message\n        }`,\n      );\n    }\n  }\n\n  const gitignorePath = getDotGitignore({ installDir });\n  const envFiles = ['.env', '.env.local'];\n\n  if (gitignorePath) {\n    const gitignoreContent = fs.readFileSync(gitignorePath, 'utf8');\n    const missingEnvFiles = envFiles.filter(\n      (file) => !gitignoreContent.includes(file),\n    );\n\n    if (missingEnvFiles.length > 0) {\n      try {\n        const newGitignoreContent = `${gitignoreContent}\\n${missingEnvFiles.join(\n          '\\n',\n        )}`;\n        await fs.promises.writeFile(gitignorePath, newGitignoreContent, {\n          encoding: 'utf8',\n          flag: 'w',\n        });\n        clack.log.success(\n          `Updated ${chalk.bold.cyan(\n            '.gitignore',\n          )} to include environment files.`,\n        );\n      } catch (error) {\n        clack.log.warning(\n          `Failed to update ${chalk.bold.cyan(\n            '.gitignore',\n          )} to include environment files. Error: ${error.message}`,\n        );\n      }\n    }\n  } else {\n    try {\n      const newGitignoreContent = `${envFiles.join('\\n')}\\n`;\n      await fs.promises.writeFile(\n        path.join(installDir, '.gitignore'),\n        newGitignoreContent,\n        {\n          encoding: 'utf8',\n          flag: 'w',\n        },\n      );\n      clack.log.success(\n        `Created ${chalk.bold.cyan('.gitignore')} with environment files.`,\n      );\n    } catch (error) {\n      clack.log.warning(\n        `Failed to create ${chalk.bold.cyan(\n          '.gitignore',\n        )} with environment files. Error: ${error.message}`,\n      );\n    }\n  }\n\n  analytics.capture('wizard interaction', {\n    action: 'added environment variables',\n    integration,\n  });\n}\n"]}
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../../src/utils/environment.ts"],"names":[],"mappings":"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","sourcesContent":["import path from 'path';\nimport readEnv from 'read-env';\nimport fs from 'fs';\nimport clack from './clack';\nimport chalk from 'chalk';\nimport { getDotGitignore } from './file-utils';\nimport { Integration } from '../lib/constants';\nimport { analytics } from './analytics';\nimport { getPackageDotJson } from './clack-utils';\nimport type { WizardOptions } from './types';\nimport fg from 'fast-glob';\n\nexport function readEnvironment(): Record<string, unknown> {\n  const result = readEnv('POSTHOG_WIZARD');\n\n  return result;\n}\n\nexport async function addOrUpdateEnvironmentVariables({\n  installDir,\n  variables,\n  integration,\n}: {\n  installDir: string;\n  variables: Record<string, string>;\n  integration: Integration;\n}): Promise<void> {\n  const envVarContent = Object.entries(variables)\n    .map(([key, value]) => `${key}=${value}`)\n    .join('\\n');\n\n  const dotEnvLocalFilePath = path.join(installDir, '.env.local');\n  const dotEnvFilePath = path.join(installDir, '.env');\n  const targetEnvFilePath = fs.existsSync(dotEnvLocalFilePath)\n    ? dotEnvLocalFilePath\n    : dotEnvFilePath;\n\n  const dotEnvFileExists = fs.existsSync(targetEnvFilePath);\n\n  const relativeEnvFilePath = path.relative(installDir, targetEnvFilePath);\n\n  if (dotEnvFileExists) {\n    try {\n      let dotEnvFileContent = fs.readFileSync(targetEnvFilePath, 'utf8');\n      let updated = false;\n\n      for (const [key, value] of Object.entries(variables)) {\n        const regex = new RegExp(`^${key}=.*$`, 'm');\n\n        if (dotEnvFileContent.match(regex)) {\n          dotEnvFileContent = dotEnvFileContent.replace(\n            regex,\n            `${key}=${value}`,\n          );\n          updated = true;\n        } else {\n          if (!dotEnvFileContent.endsWith('\\n')) {\n            dotEnvFileContent += '\\n';\n          }\n          dotEnvFileContent += `${key}=${value}\\n`;\n          updated = true;\n        }\n      }\n\n      if (updated) {\n        await fs.promises.writeFile(targetEnvFilePath, dotEnvFileContent, {\n          encoding: 'utf8',\n          flag: 'w',\n        });\n        clack.log.success(\n          `Updated environment variables in ${chalk.bold.cyan(\n            relativeEnvFilePath,\n          )}`,\n        );\n      } else {\n        clack.log.success(\n          `${chalk.bold.cyan(\n            relativeEnvFilePath,\n          )} already has the necessary environment variables.`,\n        );\n      }\n    } catch (error) {\n      clack.log.warning(\n        `Failed to update environment variables in ${chalk.bold.cyan(\n          relativeEnvFilePath,\n        )}. Please update them manually. Error: ${error.message}`,\n      );\n    }\n  } else {\n    try {\n      await fs.promises.writeFile(targetEnvFilePath, envVarContent, {\n        encoding: 'utf8',\n        flag: 'w',\n      });\n      clack.log.success(\n        `Created ${chalk.bold.cyan(\n          relativeEnvFilePath,\n        )} with environment variables.`,\n      );\n    } catch (error) {\n      clack.log.warning(\n        `Failed to create ${chalk.bold.cyan(\n          relativeEnvFilePath,\n        )} with environment variables. Please add them manually. Error: ${\n          error.message\n        }`,\n      );\n    }\n  }\n\n  const gitignorePath = getDotGitignore({ installDir });\n  const envFiles = ['.env', '.env.local'];\n\n  if (gitignorePath) {\n    const gitignoreContent = fs.readFileSync(gitignorePath, 'utf8');\n    const missingEnvFiles = envFiles.filter(\n      (file) => !gitignoreContent.includes(file),\n    );\n\n    if (missingEnvFiles.length > 0) {\n      try {\n        const newGitignoreContent = `${gitignoreContent}\\n${missingEnvFiles.join(\n          '\\n',\n        )}`;\n        await fs.promises.writeFile(gitignorePath, newGitignoreContent, {\n          encoding: 'utf8',\n          flag: 'w',\n        });\n        clack.log.success(\n          `Updated ${chalk.bold.cyan(\n            '.gitignore',\n          )} to include environment files.`,\n        );\n      } catch (error) {\n        clack.log.warning(\n          `Failed to update ${chalk.bold.cyan(\n            '.gitignore',\n          )} to include environment files. Error: ${error.message}`,\n        );\n      }\n    }\n  } else {\n    try {\n      const newGitignoreContent = `${envFiles.join('\\n')}\\n`;\n      await fs.promises.writeFile(\n        path.join(installDir, '.gitignore'),\n        newGitignoreContent,\n        {\n          encoding: 'utf8',\n          flag: 'w',\n        },\n      );\n      clack.log.success(\n        `Created ${chalk.bold.cyan('.gitignore')} with environment files.`,\n      );\n    } catch (error) {\n      clack.log.warning(\n        `Failed to create ${chalk.bold.cyan(\n          '.gitignore',\n        )} with environment files. Error: ${error.message}`,\n      );\n    }\n  }\n\n  analytics.capture('wizard interaction', {\n    action: 'added environment variables',\n    integration,\n  });\n}\n\nexport async function detectEnvVarPrefix(\n  options: WizardOptions,\n): Promise<string> {\n  const packageJson = await getPackageDotJson(options);\n\n  const deps = { ...packageJson.dependencies, ...packageJson.devDependencies };\n  const has = (name: string) => name in deps;\n  const hasAnyFile = async (patterns: string[]) => {\n    const matches = await fg(patterns, {\n      cwd: options.installDir,\n      absolute: false,\n      onlyFiles: true,\n      ignore: ['**/node_modules/**'],\n    });\n    return matches.length > 0;\n  };\n\n  // --- Next.js\n  if (has('next') || (await hasAnyFile(['**/next.config.{js,ts,mjs,cjs}']))) {\n    return 'NEXT_PUBLIC_';\n  }\n\n  // --- Create React App\n  if (\n    has('react-scripts') ||\n    has('create-react-app') ||\n    (await hasAnyFile(['**/config-overrides.js']))\n  ) {\n    return 'REACT_APP_';\n  }\n\n  // --- Vite (vanilla, TanStack, Solid, etc.)\n  // Note: Vite does not need PUBLIC_ but we use it to follow the docs, to improve the chances of an LLM getting it right.\n  if (has('vite') || (await hasAnyFile(['**/vite.config.{js,ts,mjs,cjs}']))) {\n    return 'VITE_PUBLIC_';\n  }\n\n  // --- SvelteKit\n  if (\n    has('@sveltejs/kit') ||\n    (await hasAnyFile(['**/svelte.config.{js,ts}']))\n  ) {\n    return 'PUBLIC_';\n  }\n\n  // --- TanStack Start (uses Vite)\n  if (\n    has('@tanstack/start') ||\n    (await hasAnyFile(['**/tanstack.config.{js,ts}']))\n  ) {\n    return 'VITE_PUBLIC_';\n  }\n\n  // --- SolidStart (uses Vite)\n  if (has('solid-start') || (await hasAnyFile(['**/solid.config.{js,ts}']))) {\n    return 'VITE_PUBLIC_';\n  }\n\n  // --- Astro\n  if (has('astro') || (await hasAnyFile(['**/astro.config.{js,ts,mjs}']))) {\n    return 'PUBLIC_';\n  }\n\n  // We default to Vite if we can't detect a specific framework, since it's the most commonly used.\n  return 'VITE_PUBLIC_';\n}\n"]}

package/dist/src/utils/rules/add-editor-rules.d.ts

@@ -0,0 +1,9 @@
+import { Integration } from '../../lib/constants';
+type AddEditorRulesOptions = {
+    installDir: string;
+    rulesName: string;
+    integration: Integration;
+    default?: boolean;
+};
+export declare const addEditorRules: ({ installDir, rulesName, integration, default: defaultAddEditorRules, }: AddEditorRulesOptions) => Promise<void>;
+export {};

package/dist/src/utils/rules/add-editor-rules.js

@@ -0,0 +1,88 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addEditorRules = void 0;
+const fs = __importStar(require("fs"));
+const chalk_1 = __importDefault(require("chalk"));
+const path_1 = __importDefault(require("path"));
+const analytics_1 = require("../analytics");
+const clack_1 = __importDefault(require("../clack"));
+const telemetry_1 = require("../../telemetry");
+const clack_utils_1 = require("../clack-utils");
+const addEditorRules = async ({ installDir, rulesName, integration, default: defaultAddEditorRules, }) => {
+    // Add rules file if in Cursor environment
+    if (process.env.CURSOR_TRACE_ID) {
+        const addEditorRules = defaultAddEditorRules
+            ? true
+            : await (0, clack_utils_1.abortIfCancelled)(clack_1.default.select({
+                message: 'Would you like to have PostHog added to your Cursor rules?',
+                options: [
+                    {
+                        label: 'Yes, please!',
+                        value: true,
+                    },
+                    {
+                        label: 'No, thanks',
+                        value: false,
+                    },
+                ],
+            }));
+        if (!addEditorRules) {
+            return;
+        }
+        return (0, telemetry_1.traceStep)('add-editor-rules', async () => {
+            const docsDir = path_1.default.join(installDir, '.cursor', 'rules');
+            await fs.promises.mkdir(docsDir, { recursive: true });
+            const frameworkRules = await fs.promises.readFile(path_1.default.join(__dirname, rulesName), 'utf8');
+            const universalRulesPath = path_1.default.join(__dirname, 'universal.md');
+            const universalRules = await fs.promises.readFile(universalRulesPath, 'utf8');
+            // Replace {universal} placeholder with universal rules content
+            const combinedRules = frameworkRules.replace('{universal}', universalRules);
+            const targetPath = path_1.default.join(docsDir, 'posthog-integration.mdc');
+            // Write the combined rules
+            await fs.promises.writeFile(targetPath, combinedRules, 'utf8');
+            analytics_1.analytics.capture('wizard interaction', {
+                action: 'added editor rules',
+                integration,
+            });
+            clack_1.default.log.info(`Added Cursor rules to ${chalk_1.default.bold.cyan(docsDir)}`);
+        });
+    }
+};
+exports.addEditorRules = addEditorRules;
+//# sourceMappingURL=add-editor-rules.js.map

package/dist/src/utils/rules/add-editor-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-editor-rules.js","sourceRoot":"","sources":["../../../../src/utils/rules/add-editor-rules.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,kDAA0B;AAC1B,gDAAwB;AAExB,4CAAyC;AACzC,qDAA6B;AAC7B,+CAA4C;AAC5C,gDAAkD;AAS3C,MAAM,cAAc,GAAG,KAAK,EAAE,EACnC,UAAU,EACV,SAAS,EACT,WAAW,EACX,OAAO,EAAE,qBAAqB,GACR,EAAE,EAAE;IAC1B,0CAA0C;IAC1C,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;QAChC,MAAM,cAAc,GAAY,qBAAqB;YACnD,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,MAAM,IAAA,8BAAgB,EACpB,eAAK,CAAC,MAAM,CAAC;gBACX,OAAO,EACL,4DAA4D;gBAC9D,OAAO,EAAE;oBACP;wBACE,KAAK,EAAE,cAAc;wBACrB,KAAK,EAAE,IAAI;qBACZ;oBACD;wBACE,KAAK,EAAE,YAAY;wBACnB,KAAK,EAAE,KAAK;qBACb;iBACF;aACF,CAAC,CACH,CAAC;QAEN,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QAED,OAAO,IAAA,qBAAS,EAAC,kBAAkB,EAAE,KAAK,IAAI,EAAE;YAC9C,MAAM,OAAO,GAAG,cAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YAE1D,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAEtD,MAAM,cAAc,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAC/C,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,EAC/B,MAAM,CACP,CAAC;YACF,MAAM,kBAAkB,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;YAEhE,MAAM,cAAc,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAC/C,kBAAkB,EAClB,MAAM,CACP,CAAC;YAEF,+DAA+D;YAC/D,MAAM,aAAa,GAAG,cAAc,CAAC,OAAO,CAC1C,aAAa,EACb,cAAc,CACf,CAAC;YACF,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,OAAO,EAAE,yBAAyB,CAAC,CAAC;YAEjE,2BAA2B;YAC3B,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,UAAU,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;YAE/D,qBAAS,CAAC,OAAO,CAAC,oBAAoB,EAAE;gBACtC,MAAM,EAAE,oBAAoB;gBAC5B,WAAW;aACZ,CAAC,CAAC;YAEH,eAAK,CAAC,GAAG,CAAC,IAAI,CAAC,yBAAyB,eAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACtE,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC;AAjEW,QAAA,cAAc,kBAiEzB","sourcesContent":["import * as fs from 'fs';\nimport chalk from 'chalk';\nimport path from 'path';\nimport { Integration } from '../../lib/constants';\nimport { analytics } from '../analytics';\nimport clack from '../clack';\nimport { traceStep } from '../../telemetry';\nimport { abortIfCancelled } from '../clack-utils';\n\ntype AddEditorRulesOptions = {\n  installDir: string;\n  rulesName: string;\n  integration: Integration;\n  default?: boolean;\n};\n\nexport const addEditorRules = async ({\n  installDir,\n  rulesName,\n  integration,\n  default: defaultAddEditorRules,\n}: AddEditorRulesOptions) => {\n  // Add rules file if in Cursor environment\n  if (process.env.CURSOR_TRACE_ID) {\n    const addEditorRules: boolean = defaultAddEditorRules\n      ? true\n      : await abortIfCancelled(\n          clack.select({\n            message:\n              'Would you like to have PostHog added to your Cursor rules?',\n            options: [\n              {\n                label: 'Yes, please!',\n                value: true,\n              },\n              {\n                label: 'No, thanks',\n                value: false,\n              },\n            ],\n          }),\n        );\n\n    if (!addEditorRules) {\n      return;\n    }\n\n    return traceStep('add-editor-rules', async () => {\n      const docsDir = path.join(installDir, '.cursor', 'rules');\n\n      await fs.promises.mkdir(docsDir, { recursive: true });\n\n      const frameworkRules = await fs.promises.readFile(\n        path.join(__dirname, rulesName),\n        'utf8',\n      );\n      const universalRulesPath = path.join(__dirname, 'universal.md');\n\n      const universalRules = await fs.promises.readFile(\n        universalRulesPath,\n        'utf8',\n      );\n\n      // Replace {universal} placeholder with universal rules content\n      const combinedRules = frameworkRules.replace(\n        '{universal}',\n        universalRules,\n      );\n      const targetPath = path.join(docsDir, 'posthog-integration.mdc');\n\n      // Write the combined rules\n      await fs.promises.writeFile(targetPath, combinedRules, 'utf8');\n\n      analytics.capture('wizard interaction', {\n        action: 'added editor rules',\n        integration,\n      });\n\n      clack.log.info(`Added Cursor rules to ${chalk.bold.cyan(docsDir)}`);\n    });\n  }\n};\n"]}

package/dist/src/utils/rules/add-editor-rules.ts

@@ -0,0 +1,82 @@
+import * as fs from 'fs';
+import chalk from 'chalk';
+import path from 'path';
+import { Integration } from '../../lib/constants';
+import { analytics } from '../analytics';
+import clack from '../clack';
+import { traceStep } from '../../telemetry';
+import { abortIfCancelled } from '../clack-utils';
+
+type AddEditorRulesOptions = {
+  installDir: string;
+  rulesName: string;
+  integration: Integration;
+  default?: boolean;
+};
+
+export const addEditorRules = async ({
+  installDir,
+  rulesName,
+  integration,
+  default: defaultAddEditorRules,
+}: AddEditorRulesOptions) => {
+  // Add rules file if in Cursor environment
+  if (process.env.CURSOR_TRACE_ID) {
+    const addEditorRules: boolean = defaultAddEditorRules
+      ? true
+      : await abortIfCancelled(
+          clack.select({
+            message:
+              'Would you like to have PostHog added to your Cursor rules?',
+            options: [
+              {
+                label: 'Yes, please!',
+                value: true,
+              },
+              {
+                label: 'No, thanks',
+                value: false,
+              },
+            ],
+          }),
+        );
+
+    if (!addEditorRules) {
+      return;
+    }
+
+    return traceStep('add-editor-rules', async () => {
+      const docsDir = path.join(installDir, '.cursor', 'rules');
+
+      await fs.promises.mkdir(docsDir, { recursive: true });
+
+      const frameworkRules = await fs.promises.readFile(
+        path.join(__dirname, rulesName),
+        'utf8',
+      );
+      const universalRulesPath = path.join(__dirname, 'universal.md');
+
+      const universalRules = await fs.promises.readFile(
+        universalRulesPath,
+        'utf8',
+      );
+
+      // Replace {universal} placeholder with universal rules content
+      const combinedRules = frameworkRules.replace(
+        '{universal}',
+        universalRules,
+      );
+      const targetPath = path.join(docsDir, 'posthog-integration.mdc');
+
+      // Write the combined rules
+      await fs.promises.writeFile(targetPath, combinedRules, 'utf8');
+
+      analytics.capture('wizard interaction', {
+        action: 'added editor rules',
+        integration,
+      });
+
+      clack.log.info(`Added Cursor rules to ${chalk.bold.cyan(docsDir)}`);
+    });
+  }
+};

package/dist/src/utils/rules/next-rules.md

@@ -0,0 +1,9 @@
+---
+description: apply when interacting with PostHog/analytics tasks
+globs: 
+alwaysApply: true
+---
+
+{universal}
+
+

package/dist/src/utils/rules/react-rules.md

@@ -0,0 +1,7 @@
+---
+description: apply when interacting with PostHog/analytics tasks
+globs: 
+alwaysApply: true
+---
+
+{universal}

package/dist/src/utils/rules/universal.md

@@ -0,0 +1,20 @@
+Never hallucinate an API key. Instead, always use the API key populated in the .env file.
+
+# Feature flags
+
+A given feature flag should be used in as few places as possible. Do not increase the risk of undefined behavior by scattering the same feature flag across multiple areas of code. If the same feature flag needs to be introduced at multiple callsites, flag this for the developer to inspect carefully.
+
+If a job requires creating new feature flag names, make them as clear and descriptive as possible.
+
+If using TypeScript, use an enum to store flag names. If using JavaScript, store flag names as strings to an object declared as a constant, to simulate an enum. Use a consistent naming convention for this storage. enum/const object members should be written UPPERCASE_WITH_UNDERSCORE.
+
+Gate flag-dependent code on a check that verifies the flag's values are valid and expected.
+
+# Custom properties
+
+If a custom property for a person or event is at any point referenced in two or more files or two or more callsites in the same file, use an enum or const object, as above in feature flags.
+
+# Naming
+
+Before creating any new event or property names, consult with the developer for any existing naming convention. Consistency in naming is essential, and additional context may exist outside this project. Similarly, be careful about any changes to existing event and property names, as this may break reporting and distort data for the project.
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@posthog/wizard",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "homepage": "https://github.com/posthog/wizard",
   "repository": "https://github.com/posthog/wizard",
   "description": "The PostHog wizard helps you to configure your project",
@@ -123,7 +123,7 @@
     "prebuild": "pnpm clean",
     "build:watch": "pnpm tsc -w",
     "build": "pnpm tsc",
-    "postbuild": "chmod +x ./dist/bin.js && cp -r scripts/** dist",
+    "postbuild": "chmod +x ./dist/bin.js && cp -r scripts/** dist && cp -r src/utils/rules dist/src/utils",
     "lint": "pnpm lint:prettier && pnpm lint:eslint",
     "lint:prettier": "prettier --check \"{lib,src,test}/**/*.ts\"",
     "lint:eslint": "eslint . --cache --format stylish",