feat: add Astro support to PostHog Wizard (#67)

* Adds initial Astro test application setup

Implements a basic structure for an Astro test application.

Includes essential files like configuration, package.json, and a README for guidance. Also introduces a PostHog component for analytics tracking and basic layout integration.

Updates the .gitignore to exclude unnecessary files and folders specific to build processes and local configurations.

Prepares for project expansion by setting up TypeScript support.

This foundational setup ensures a clean start for future development and testing.

* add PostHog integration AI guidelines for Astro project

* Adds PostHog Astro wizard for seamless integration

Implements an interactive wizard for integrating PostHog with Astro applications.

The wizard guides users through installation steps, including setting up environment variables, confirming use of TypeScript, and handling package installations. It ensures users have the necessary packages and provides documentation for further configuration.

This addition enhances user experience by automating setup tasks and providing clear installation instructions. It further sets up analytics to track Astro version and SDK installation status.

No related issues or tickets are referenced.

* Adds Astro integration support to analytics setup

Implements support for the Astro integration, enhancing the application’s analytics setup capabilities.

- Introduces the Astro configuration including detection and file filtering patterns.
- Adds Astro to the integration order and allows for running the associated setup wizard.
- Updates integration descriptions for better clarity in user prompts.

This addition streamlines the setup process for Astro projects and improves overall analytics functionality.

* Adds end-to-end tests for Astro application

Implements a suite of end-to-end tests for the Astro application, ensuring its functionality in various environments.

Tests include verification of `package.json` updates, successful runs in development and production modes, and build correctness.

This facilitates automated testing and quality assurance in the deployment process.

* Updates README to include Astro integration

Adds Astro to the list of supported frameworks for the wizard.

Updates the CLI integration options to reflect this new addition.

Encourages users to suggest further integrations via GitHub issues.

* Enhances Astro Wizard for improved PostHog integration

Refactors the Astro wizard to streamline PostHog integration steps.

Removes unnecessary TypeScript checks and redundant package installations, simplifying the user flow.

Introduces a new documentation structure and code snippets for easier implementation guidance.

Aims to improve user experience and integration efficiency for analytics in Astro projects.

* Removes environment variable steps from wizard

Eliminates the steps for adding or updating environment variables in the Astro wizard process.

Updates the default changes in the integration configuration to reflect these removals while maintaining the functionality of the PostHog component.

This streamlining aims to simplify the wizard experience and reduce complexity in managing environment variables.

* Removes outdated PostHog documentation sections

Cleans up the documentation by removing irrelevant Next Steps
related to PostHog instrumentation. This improves clarity
for users by eliminating confusion over previously suggested
steps no longer applicable.

Updates content to streamline the user experience in the
Astro and Next.js documentation sources.

* Updates posthog initialization with default date

Incorporates a default value for the date in the posthog initialization.

This change enhances the analytics integration by setting a specific defaults parameter, allowing for more consistent data handling.

* Removes posthog components from Astro test app for more integral test

Upgrades the Astro framework version to 5.10.1 and removes the PostHog integration components to have bare minimum for more accurate E2E tests

Author: AbdallahAHO

README.md

@@ -17,7 +17,7 @@ To use the wizard, you can run it directly using:
 npx @posthog/wizard
 ```
 
-Currently the wizard can be used for **React, NextJS, Svelte and React Native**
+Currently the wizard can be used for **React, NextJS, Svelte, Astro and React Native**
 projects. If you have other integrations you would like the wizard to support,
 please open a [GitHub issue](https://github.com/posthog/wizard/issues)!
 
@@ -30,7 +30,7 @@ The following CLI arguments are available:
 | `--help`          | Show help                                                                  | boolean |                                 |                                             |                              |
 | `--version`       | Show version number                                                        | boolean |                                 |                                             |                              |
 | `--debug`         | Enable verbose logging                                                     | boolean | `false`                         |                                             | `POSTHOG_WIZARD_DEBUG`       |
-| `--integration`   | Choose the integration to setup                                            | choices | Select integration during setup | "nextjs", "react", "svelte", "react-native" | `POSTHOG_WIZARD_INTEGRATION` |
+| `--integration`   | Choose the integration to setup                                            | choices | Select integration during setup | "nextjs", "astro", "react", "svelte", "react-native" | `POSTHOG_WIZARD_INTEGRATION` |
 | `--force-install` | Force install the SDK NPM package (use with caution!)                      | boolean | `false`                         |                                             |                              |
 | `--install-dir`   | Relative path to install in                                                | string  | `.`                             |                                             | `POSTHOG_WIZARD_INSTALL_DIR` |
 | `--region`        | PostHog region to use                                                      | choices |                                 | "us", "eu"                                  | `POSTHOG_WIZARD_REGION`      |

bin.ts

@@ -64,7 +64,7 @@ yargs(hideBin(process.argv))
         },
         integration: {
           describe: 'Integration to set up',
-          choices: ['nextjs', 'react', 'svelte', 'react-native'],
+          choices: ['nextjs', 'astro', 'react', 'svelte', 'react-native'],
           type: 'string',
         },
       });

e2e-tests/test-applications/astro-test-app/.gitignore

@@ -0,0 +1,24 @@
+# build output
+dist/
+# generated types
+.astro/
+
+# dependencies
+node_modules/
+
+# logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+
+# environment variables
+.env
+.env.production
+
+# macOS-specific files
+.DS_Store
+
+# jetbrains setting folder
+.idea/

e2e-tests/test-applications/astro-test-app/.vscode/extensions.json

@@ -0,0 +1,4 @@
+{
+  "recommendations": ["astro-build.astro-vscode"],
+  "unwantedRecommendations": []
+}

e2e-tests/test-applications/astro-test-app/.vscode/launch.json

@@ -0,0 +1,11 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "command": "./node_modules/.bin/astro dev",
+      "name": "Development server",
+      "request": "launch",
+      "type": "node-terminal"
+    }
+  ]
+}

e2e-tests/test-applications/astro-test-app/README.md

@@ -0,0 +1,47 @@
+# Astro Starter Kit: Minimal
+
+```sh
+npm create astro@latest -- --template minimal
+```
+
+[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/astro/tree/latest/examples/minimal)
+[![Open with CodeSandbox](https://assets.codesandbox.io/github/button-edit-lime.svg)](https://codesandbox.io/p/sandbox/github/withastro/astro/tree/latest/examples/minimal)
+[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/withastro/astro?devcontainer_path=.devcontainer/minimal/devcontainer.json)
+
+> 🧑‍🚀 **Seasoned astronaut?** Delete this file. Have fun!
+
+## 🚀 Project Structure
+
+Inside of your Astro project, you'll see the following folders and files:
+
+```text
+/
+├── public/
+├── src/
+│   └── pages/
+│       └── index.astro
+└── package.json
+```
+
+Astro looks for `.astro` or `.md` files in the `src/pages/` directory. Each page is exposed as a route based on its file name.
+
+There's nothing special about `src/components/`, but that's where we like to put any Astro/React/Vue/Svelte/Preact components.
+
+Any static assets, like images, can be placed in the `public/` directory.
+
+## 🧞 Commands
+
+All commands are run from the root of the project, from a terminal:
+
+| Command                   | Action                                           |
+| :------------------------ | :----------------------------------------------- |
+| `npm install`             | Installs dependencies                            |
+| `npm run dev`             | Starts local dev server at `localhost:4321`      |
+| `npm run build`           | Build your production site to `./dist/`          |
+| `npm run preview`         | Preview your build locally, before deploying     |
+| `npm run astro ...`       | Run CLI commands like `astro add`, `astro check` |
+| `npm run astro -- --help` | Get help using the Astro CLI                     |
+
+## 👀 Want to learn more?
+
+Feel free to check [our documentation](https://docs.astro.build) or jump into our [Discord server](https://astro.build/chat).

e2e-tests/test-applications/astro-test-app/astro.config.mjs

@@ -0,0 +1,5 @@
+// @ts-check
+import { defineConfig } from 'astro/config';
+
+// https://astro.build/config
+export default defineConfig({});