configure-wasp

name	configure-wasp
description	configure Wasp framework features and set up their app's branding (meta tags, SEO), authentication (email, social auth providers), database, email providers, styling (tailwind, shadcn), etc. Use when the user wants to add or set up Wasp-specific functionality.

configure-wasp

Configure Wasp framework features and integrations. Each invocation focuses on one feature at a time.

Before Starting

1. Verify user is in the Wasp project root directory (check for wasp config file: main.wasp or main.wasp.ts)

Available Wasp Features

Present these features to the user and let them choose ONE to configure:

Feature	Description
App Branding	Set your app's name, description, and meta tags
Authentication	Add login methods (Email, Google, GitHub, etc.)
Email Provider	Configure email sending (SendGrid, Mailgun, etc.)
Database	Set up your database (PostgreSQL, SQLite, etc.)
Styling (CSS, UI)	Add Tailwind CSS or ShadCN UI (on top of Tailwind CSS)
Verify Setup	Test that your app compiles and runs correctly

Feature Selection

Using the AskUserQuestion tool, ask the user which Wasp feature they'd like to configure:

• Use the most relevant options as selectable choices (limited to 2-4 options)
• Remind users they can select "Other" to choose from additional features

Execute Selected Feature

Based on the user's selection, follow the corresponding guides below. ALWAYS follow the feature guide's corresponding raw text documentation URLs and use it as the basis for assisting the user.

• App Branding → app-branding.md
• Authentication → authentication.md
• Email Provider → email-provider.md
• Database → database.md
• Styling (CSS, UI) → styling.md
• Verify Setup → verify-setup.md

Guidelines for Using AskUserQuestion with Lists

When asking the user to choose from fetched lists (e.g., auth methods, email providers):

1. Always display the full list to the user before asking them to choose, so they know all available options.
2. Use the most popular/common options as the selectable choices in AskUserQuestion (limited to 2-4 options).
3. Remind users they can select "Other" to specify any option from the full list that isn't shown in the quick-select options.
4. Example format:

   Available auth methods: Username & Password, Email, Google, GitHub, Discord, Keycloak, Slack
   
   [AskUserQuestion with 3-4 most common options]
   
   Note: Select "Other" to choose from additional options like Discord, Keycloak, or Slack.
   

After Feature Completion

After completing a feature configuration:

1. Summarize the changes made
2. If applicable, let them know if there are any environment variables they need to set and ask them if they need guidance on how to set them

• if so, fetch the raw github doc file URL for the environment variables and guide the user through the process

3. Ask if the user would like to configure another feature
4. If yes, return to Feature Selection
5. If no, suggest running "Verify Setup" if they haven't already