rename basics to example-apps

Author: edwinyjlim

.github/workflows/e2e.yml

@@ -27,7 +27,7 @@ jobs:
     - name: Discover examples with Playwright configs
       id: set-examples
       run: |
-        examples=$(find basics -maxdepth 2 -name "playwright.config.ts" -exec dirname {} \; | sed 's|^basics/||' | jq -R -s -c 'split("\n")[:-1]')
+        examples=$(find example-apps -maxdepth 2 -name "playwright.config.ts" -exec dirname {} \; | sed 's|^example-apps/||' | jq -R -s -c 'split("\n")[:-1]')
         echo "examples=$examples" >> $GITHUB_OUTPUT
         echo "Found examples: $examples"
 
@@ -53,17 +53,17 @@ jobs:
 
     - name: Install dependencies
       run: |
-        cd basics/${{ matrix.example }}
+        cd example-apps/${{ matrix.example }}
         pnpm install
 
     - name: Install Playwright Browsers
       run: |
-        cd basics/${{ matrix.example }}
+        cd example-apps/${{ matrix.example }}
         pnpm exec playwright install chromium --with-deps
 
     - name: Run E2E Playwright tests
       run: |
-        cd basics/${{ matrix.example }}
+        cd example-apps/${{ matrix.example }}
         pnpm run test:e2e
       env:
         NEXT_PUBLIC_POSTHOG_KEY: ${{ vars.NEXT_PUBLIC_POSTHOG_KEY }}
@@ -105,6 +105,6 @@ jobs:
       if: always()
       with:
         name: playwright-report-${{ matrix.example }}
-        path: basics/${{ matrix.example }}/playwright-report/
+        path: example-apps/${{ matrix.example }}/playwright-report/
         retention-days: 30
 

.github/workflows/integration.yml

@@ -31,7 +31,7 @@ jobs:
     - name: Discover examples with Playwright configs
       id: set-examples
       run: |
-        examples=$(find basics -maxdepth 2 -name "playwright.config.ts" -exec dirname {} \; | sed 's|^basics/||' | jq -R -s -c 'split("\n")[:-1]')
+        examples=$(find example-apps -maxdepth 2 -name "playwright.config.ts" -exec dirname {} \; | sed 's|^example-apps/||' | jq -R -s -c 'split("\n")[:-1]')
         echo "examples=$examples" >> $GITHUB_OUTPUT
         echo "Found examples: $examples"
 
@@ -57,17 +57,17 @@ jobs:
 
     - name: Install dependencies
       run: |
-        cd basics/${{ matrix.example }}
+        cd example-apps/${{ matrix.example }}
         pnpm install
 
     - name: Install Playwright Browsers
       run: |
-        cd basics/${{ matrix.example }}
+        cd example-apps/${{ matrix.example }}
         pnpm exec playwright install chromium --with-deps
 
     - name: Run Integration Playwright tests
       run: |
-        cd basics/${{ matrix.example }}
+        cd example-apps/${{ matrix.example }}
         pnpm run test:integration
       env:
         NEXT_PUBLIC_POSTHOG_KEY: ${{ vars.NEXT_PUBLIC_POSTHOG_KEY }}
@@ -107,5 +107,5 @@ jobs:
       if: always()
       with:
         name: playwright-report-${{ matrix.example }}
-        path: basics/${{ matrix.example }}/playwright-report/
+        path: example-apps/${{ matrix.example }}/playwright-report/
         retention-days: 30

.semgrepignore

@@ -10,12 +10,12 @@
 
 # Android launcher activity exported=true is required for MAIN/LAUNCHER intent filter
 # This is standard React Native / Android boilerplate, not a security issue
-basics/react-native/android/app/src/main/AndroidManifest.xml
-basics/expo/android/app/src/main/AndroidManifest.xml
-basics/android/app/src/main/AndroidManifest.xml
+example-apps/react-native/android/app/src/main/AndroidManifest.xml
+example-apps/expo/android/app/src/main/AndroidManifest.xml
+example-apps/android/app/src/main/AndroidManifest.xml
 
 # Markdown audit reference contains HogQL examples with PostHog $host event property.
 # Semgrep's nginx host-header rule misidentifies this docs-only SQL as nginx config.
-transformation-config/skills/audit-events/references/3-events-optimize.md
-transformation-config/skills/web-analytics/references/checks.md
-transformation-config/skills/web-analytics/references/remediation.md
+context/skills/audit-events/references/3-events-optimize.md
+context/skills/web-analytics/references/checks.md
+context/skills/web-analytics/references/remediation.md

context/skills/integration/config.yaml

@@ -6,158 +6,158 @@ shared_docs:
   - https://posthog.com/docs/getting-started/identify-users.md
 variants:
   - id: nextjs-app-router
-    example_paths: basics/next-app-router
+    example_paths: example-apps/next-app-router
     display_name: Next.js App Router
     tags: [nextjs, react, ssr, app-router, javascript]
     docs_urls:
       - https://posthog.com/docs/libraries/next-js.md
 
   - id: nextjs-pages-router
-    example_paths: basics/next-pages-router
+    example_paths: example-apps/next-pages-router
     display_name: Next.js Pages Router
     tags: [nextjs, react, ssr, pages-router, javascript]
     docs_urls:
       - https://posthog.com/docs/libraries/next-js.md
 
   - id: react-react-router-6
-    example_paths: basics/react-react-router-6
+    example_paths: example-apps/react-react-router-6
     display_name: React Router v6
     tags: [react, react-router, v6, spa, javascript]
     docs_urls:
       - https://posthog.com/docs/libraries/react-router/react-router-v6.md
 
   - id: react-react-router-7-framework
-    example_paths: basics/react-react-router-7-framework
+    example_paths: example-apps/react-react-router-7-framework
     display_name: React Router v7 - Framework mode
     tags: [react, react-router, v7, framework, ssr, javascript]
     docs_urls:
       - https://posthog.com/docs/libraries/react-router/react-router-v7-framework-mode.md
 
   - id: react-react-router-7-data
-    example_paths: basics/react-react-router-7-data
+    example_paths: example-apps/react-react-router-7-data
     display_name: React Router v7 - Data mode
     tags: [react, react-router, v7, data, spa, javascript]
     docs_urls:
       - https://posthog.com/docs/libraries/react-router/react-router-v7-data-mode.md
 
   - id: react-react-router-7-declarative
-    example_paths: basics/react-react-router-7-declarative
+    example_paths: example-apps/react-react-router-7-declarative
     display_name: React Router v7 - Declarative mode
     tags: [react, react-router, v7, declarative, spa, javascript]
     docs_urls:
       - https://posthog.com/docs/libraries/react-router/react-router-v7-declarative-mode.md
 
   - id: react-vite
-    example_path: basics/react-vite
+    example_path: example-apps/react-vite
     display_name: React (Vite)
     description: PostHog integration for React applications built with Vite (no router)
     tags: [react, vite, spa, javascript]
     docs_urls:
       - https://posthog.com/docs/libraries/react.md
 
   - id: nuxt-3-6
-    example_paths: basics/nuxt-3-6
+    example_paths: example-apps/nuxt-3-6
     display_name: Nuxt 3.6
     description: PostHog integration for Nuxt versions 3.0 to 3.6
     tags: [nuxt, javascript]
     docs_urls:
       - https://posthog.com/docs/libraries/nuxt-js-3-6.md
 
   - id: nuxt-4
-    example_paths: basics/nuxt-4
+    example_paths: example-apps/nuxt-4
     display_name: Nuxt 4
     description: PostHog integration for Nuxt 4 applications
     tags: [nuxt, vue, ssr, javascript, typescript]
     docs_urls:
       - https://posthog.com/docs/libraries/nuxt-js.md
 
   - id: vue-3
-    example_paths: basics/vue-3
+    example_paths: example-apps/vue-3
     display_name: Vue 3
     description: PostHog integration for Vue 3 applications
     tags: [vue, javascript, typescript]
     docs_urls:
       - https://posthog.com/docs/libraries/vue-js.md
 
   - id: django
-    example_paths: basics/django
+    example_paths: example-apps/django
     display_name: Django
     tags: [django, python]
     docs_urls:
       - https://posthog.com/docs/libraries/django.md
 
   - id: flask
-    example_paths: basics/flask
+    example_paths: example-apps/flask
     display_name: Flask
     tags: [flask, python]
     docs_urls:
       - https://posthog.com/docs/libraries/flask.md
 
   - id: fastapi
-    example_paths: basics/fastapi
+    example_paths: example-apps/fastapi
     display_name: FastAPI
     description: PostHog integration for FastAPI applications
     tags: [fastapi, python]
     docs_urls:
       - https://posthog.com/docs/libraries/python.md
 
   - id: react-tanstack-router-file-based
-    example_paths: basics/react-tanstack-router-file-based
+    example_paths: example-apps/react-tanstack-router-file-based
     display_name: React with TanStack Router (file-based)
     description: PostHog integration for React applications using TanStack Router with file-based routing
     tags: [react, tanstack-router, spa, javascript]
     docs_urls:
       - https://posthog.com/docs/libraries/tanstack-start.md
 
   - id: react-tanstack-router-code-based
-    example_paths: basics/react-tanstack-router-code-based
+    example_paths: example-apps/react-tanstack-router-code-based
     display_name: React with TanStack Router (code-based)
     description: PostHog integration for React applications using TanStack Router with code-based routing
     tags: [react, tanstack-router, spa, javascript]
     docs_urls:
       - https://posthog.com/docs/libraries/tanstack-start.md
 
   - id: tanstack-start
-    example_paths: basics/tanstack-start
+    example_paths: example-apps/tanstack-start
     display_name: TanStack Start
     description: PostHog integration for TanStack Start full-stack applications
     tags: [react, tanstack-start, tanstack-router, javascript]
     docs_urls:
       - https://posthog.com/docs/libraries/tanstack-start.md
 
   - id: laravel
-    example_paths: basics/laravel
+    example_paths: example-apps/laravel
     display_name: Laravel
     tags: [laravel, php]
     docs_urls:
       - https://posthog.com/docs/libraries/laravel.md
 
   - id: php
-    example_paths: basics/php
+    example_paths: example-apps/php
     display_name: PHP
     description: PostHog integration for any PHP application using the PHP SDK
     tags: [php]
     docs_urls:
       - https://posthog.com/docs/libraries/php.md
 
   - id: ruby-on-rails
-    example_paths: basics/ruby-on-rails
+    example_paths: example-apps/ruby-on-rails
     display_name: Ruby on Rails
     tags: [ruby-on-rails, ruby]
     docs_urls:
       - https://posthog.com/docs/libraries/ruby-on-rails.md
       - https://posthog.com/docs/libraries/ruby.md
 
   - id: android
-    example_paths: basics/android
+    example_paths: example-apps/android
     display_name: Android
     description: PostHog integration for Android applications
     tags: [android, java, kotlin]
     docs_urls:
       - https://posthog.com/docs/libraries/android.md
 
   - id: sveltekit
-    example_paths: basics/sveltekit
+    example_paths: example-apps/sveltekit
     display_name: SvelteKit
     description: PostHog integration for SvelteKit applications
     tags: [sveltekit, svelte, javascript]
@@ -166,7 +166,7 @@ variants:
 
   # Language fallback skills, used when no specific framework is detected
   - id: python
-    example_paths: basics/python
+    example_paths: example-apps/python
     display_name: Python
     description: PostHog integration for any Python application using the Python SDK
     tags: [python]
@@ -175,7 +175,7 @@ variants:
       - https://posthog.com/docs/references/posthog-python.md
 
   - id: javascript_node
-    example_path: basics/javascript-node
+    example_path: example-apps/javascript-node
     display_name: JavaScript Node
     description: PostHog integration for server-side Node.js applications using posthog-node
     tags: [javascript_node]
@@ -184,7 +184,7 @@ variants:
       - https://posthog.com/docs/references/posthog-node.md
 
   - id: javascript_web
-    example_path: basics/javascript-web
+    example_path: example-apps/javascript-web
     display_name: JavaScript Web
     description: PostHog integration for client-side web JavaScript applications using posthog-js
     tags: [javascript_web]
@@ -193,7 +193,7 @@ variants:
       - https://posthog.com/docs/references/posthog-js.md
 
   - id: ruby
-    example_paths: basics/ruby
+    example_paths: example-apps/ruby
     display_name: Ruby
     description: PostHog integration for any Ruby application using the Ruby SDK
     tags: [ruby]
@@ -217,7 +217,7 @@ variants:
       - https://posthog.com/docs/libraries/go.md
 
   - id: swift
-    example_paths: basics/swift
+    example_paths: example-apps/swift
     display_name: Swift (iOS/macOS)
     description: PostHog integration for Swift iOS and macOS applications
     tags: [swift, ios, macos, swiftui]
@@ -235,55 +235,55 @@ variants:
       - https://posthog.com/docs/libraries/flutter.md
 
   - id: react-native
-    example_paths: basics/react-native
+    example_paths: example-apps/react-native
     display_name: React Native
     description: PostHog integration for React Native applications
     tags: [react-native, javascript, typescript]
     docs_urls:
       - https://posthog.com/docs/libraries/react-native.md
 
   - id: expo
-    example_paths: basics/expo
+    example_paths: example-apps/expo
     display_name: Expo
     description: PostHog integration for Expo applications
     tags: [expo, react-native, javascript, typescript]
     docs_urls:
       - https://posthog.com/docs/libraries/react-native.md
 
   - id: astro-static
-    example_paths: basics/astro-static
+    example_paths: example-apps/astro-static
     display_name: Astro (Static)
     description: PostHog integration for static Astro sites using SSG
     tags: [astro, javascript, typescript]
     docs_urls:
       - https://posthog.com/docs/libraries/astro.md
 
   - id: astro-view-transitions
-    example_paths: basics/astro-view-transitions
+    example_paths: example-apps/astro-view-transitions
     display_name: Astro (View Transitions)
     description: PostHog integration for Astro with ClientRouter view transitions
     tags: [astro, astro-view-transitions, javascript, typescript]
     docs_urls:
       - https://posthog.com/docs/libraries/astro.md
 
   - id: astro-ssr
-    example_paths: basics/astro-ssr
+    example_paths: example-apps/astro-ssr
     display_name: Astro (SSR)
     description: PostHog integration for server-rendered Astro applications with API routes
     tags: [astro, astro-ssr, javascript, typescript]
     docs_urls:
       - https://posthog.com/docs/libraries/astro.md
 
   - id: astro-hybrid
-    example_paths: basics/astro-hybrid
+    example_paths: example-apps/astro-hybrid
     display_name: Astro (Hybrid)
     description: PostHog integration for Astro hybrid rendering with both static and server-rendered pages
     tags: [astro, astro-hybrid, javascript, typescript]
     docs_urls:
       - https://posthog.com/docs/libraries/astro.md
 
   - id: angular
-    example_paths: basics/angular
+    example_paths: example-apps/angular
     display_name: Angular
     description: PostHog integration for Angular applications
     tags: [angular, javascript, typescript]