fraim-framework 2.0.55 → 2.0.56

package/dist/registry/workflows/startup-credits/aws-activate-application.md

@@ -0,0 +1,535 @@
+# AWS Activate Application Guide
+
+**Complete step-by-step guide with Playwright automation instructions for applying to AWS Activate Credits.**
+
+---
+
+## ⚠️ IMPORTANT: Collect User Information First
+
+**Before starting automation, you MUST ask the user for the following information:**
+
+- **Company Name**
+- **Founder/Contact Name**
+- **Email Address** (personal or business email)
+- **Phone Number** (format: digits only, no dashes)
+- **Company Website** (full URL)
+- **Founded Date** (month and year)
+- **City**
+- **State/Province**
+- **Zip/Postal Code**
+- **Country** (e.g., "United States")
+- **Industry** (e.g., "Technology", "Software & Internet")
+- **Role** (e.g., "Entrepreneur", "Founder", "Co-Founder")
+- **Application Path** (Founders for self-funded, or Portfolio if they have an Org ID)
+
+**Store these values in variables and use them throughout the automation steps below.**
+
+---
+
+## Overview
+
+**Program:** AWS Activate  
+**Credits:** $1,000 USD (Founders path) or up to $100,000 USD (Portfolio path)  
+**URL:** https://aws.amazon.com/startups/credits  
+**Processing Time:** 7-10 business days
+
+---
+
+## Prerequisites
+
+### Required Information
+- **Company Name:** [ASK USER]
+- **Founder Name:** [ASK USER]
+- **Email:** [ASK USER]
+- **Phone:** [ASK USER] (format: digits only, no dashes)
+- **Website:** [ASK USER] (full URL)
+- **Founded:** [ASK USER] (month and year)
+- **Location:** [ASK USER - City, State, Zip]
+- **State:** [ASK USER]
+- **Country:** [ASK USER]
+- **Industry:** [ASK USER] (e.g., Technology / Software & Internet)
+
+### Required Accounts
+- AWS Builder ID (create if needed)
+- AWS Account ID (optional, can create during application)
+
+---
+
+## Playwright Automation Steps
+
+### Step 1: Navigate to AWS Activate Credits Page
+
+```javascript
+// Navigate to AWS Activate Credits page
+await page.goto('https://aws.amazon.com/startups/credits');
+await page.waitForTimeout(3000);
+```
+
+**Expected Result:** Page loads showing AWS Activate information and "Apply now" button.
+
+---
+
+### Step 2: Click "Apply now" Button
+
+```javascript
+// Click the "Apply now" button
+await page.getByRole('button', { name: /apply now/i }).click();
+await page.waitForTimeout(3000);
+```
+
+**Expected Result:** Redirects to AWS sign-in page or application form.
+
+---
+
+### Step 3: Sign In with AWS Builder ID
+
+```javascript
+// If redirected to sign-in, wait for user to sign in manually
+// Or automate sign-in if credentials are available
+await page.waitForURL(/aws.amazon.com|signin.aws.amazon.com/, { timeout: 30000 });
+```
+
+**Note:** User must sign in manually with AWS Builder ID. Wait for navigation to application form.
+
+---
+
+### Step 4: Select Application Path
+
+**Option A: Activate Founders (Self-funded)**
+```javascript
+// Select "Activate Founders" path
+await page.getByRole('radio', { name: /founders|self-funded/i }).click();
+await page.waitForTimeout(1000);
+```
+
+**Option B: Activate Portfolio (If you have Org ID)**
+```javascript
+// Select "Activate Portfolio" path
+await page.getByRole('radio', { name: /portfolio|provider/i }).click();
+await page.waitForTimeout(1000);
+```
+
+**Expected Result:** Form fields appear based on selected path.
+
+---
+
+### Step 5: Fill Personal Information
+
+```javascript
+// Use user-provided information - REPLACE WITH ACTUAL VALUES FROM USER
+const firstName = '[USER_FIRST_NAME]'; // ASK USER
+const lastName = '[USER_LAST_NAME]'; // ASK USER
+const email = '[USER_EMAIL]'; // ASK USER
+const phone = '[USER_PHONE]'; // ASK USER (digits only, no dashes)
+
+// Fill first name
+await page.getByRole('textbox', { name: /first name/i }).fill(firstName);
+await page.waitForTimeout(500);
+
+// Fill last name
+await page.getByRole('textbox', { name: /last name/i }).fill(lastName);
+await page.waitForTimeout(500);
+
+// Fill email
+await page.getByRole('textbox', { name: /email/i }).fill(email);
+await page.waitForTimeout(500);
+
+// Fill phone (format: digits only, no dashes)
+await page.getByRole('textbox', { name: /phone/i }).fill(phone);
+await page.waitForTimeout(500);
+```
+
+**Expected Result:** All personal information fields are filled.
+
+---
+
+### Step 6: Fill Company Information
+
+```javascript
+// Use user-provided information - REPLACE WITH ACTUAL VALUES FROM USER
+const companyName = '[USER_COMPANY_NAME]'; // ASK USER
+const website = '[USER_WEBSITE]'; // ASK USER (full URL)
+const city = '[USER_CITY]'; // ASK USER
+const zipCode = '[USER_ZIP_CODE]'; // ASK USER
+
+// Fill company name
+await page.getByRole('textbox', { name: /company name/i }).fill(companyName);
+await page.waitForTimeout(500);
+
+// Fill company website
+await page.getByRole('textbox', { name: /website|url/i }).fill(website);
+await page.waitForTimeout(500);
+
+// Fill city
+await page.getByRole('textbox', { name: /city/i }).fill(city);
+await page.waitForTimeout(500);
+
+// Fill zip code
+await page.getByRole('textbox', { name: /zip|postal/i }).fill(zipCode);
+await page.waitForTimeout(500);
+```
+
+**Expected Result:** Company information fields are filled.
+
+---
+
+### Step 7: Select Country (Dropdown)
+
+```javascript
+// Use user-provided country - REPLACE WITH ACTUAL VALUE FROM USER
+const country = '[USER_COUNTRY]'; // ASK USER (e.g., "United States")
+
+// Click country dropdown
+await page.getByRole('combobox', { name: /country/i }).click();
+await page.waitForTimeout(1000);
+
+// Type country name to search
+await page.keyboard.type(country);
+await page.waitForTimeout(1000);
+
+// Select country from dropdown
+await page.getByRole('option', { name: new RegExp(country, 'i') }).click();
+await page.waitForTimeout(1000);
+```
+
+**Alternative Method (if typing doesn't work):**
+```javascript
+// Use evaluate to find and click the option
+const country = '[USER_COUNTRY]'; // ASK USER
+await page.evaluate((countryName) => {
+  const options = Array.from(document.querySelectorAll('[role="option"]'));
+  const countryOption = options.find(opt => 
+    opt.textContent.toLowerCase().includes(countryName.toLowerCase())
+  );
+  if (countryOption) countryOption.click();
+}, country);
+await page.waitForTimeout(1000);
+```
+
+**Expected Result:** Country is selected.
+
+---
+
+### Step 8: Select State/Province (Dropdown)
+
+```javascript
+// Use user-provided state - REPLACE WITH ACTUAL VALUE FROM USER
+const state = '[USER_STATE]'; // ASK USER (e.g., "Washington" or "WA")
+
+// Click state dropdown
+await page.getByRole('combobox', { name: /state|province/i }).click();
+await page.waitForTimeout(1000);
+
+// Type state name
+await page.keyboard.type(state);
+await page.waitForTimeout(1000);
+
+// Select state from dropdown
+await page.getByRole('option', { name: new RegExp(state, 'i') }).click();
+await page.waitForTimeout(1000);
+```
+
+**Alternative Method:**
+```javascript
+// Scroll and click if needed
+const state = '[USER_STATE]'; // ASK USER
+await page.evaluate((stateName) => {
+  const options = Array.from(document.querySelectorAll('[role="option"]'));
+  const stateOption = options.find(opt => 
+    opt.textContent.match(new RegExp(stateName, 'i'))
+  );
+  if (stateOption) {
+    stateOption.scrollIntoView({ behavior: 'smooth', block: 'center' });
+    setTimeout(() => stateOption.click(), 500);
+  }
+}, state);
+await page.waitForTimeout(1500);
+```
+
+**Expected Result:** State is selected.
+
+---
+
+### Step 9: Select Industry (Dropdown)
+
+```javascript
+// Use user-provided industry - REPLACE WITH ACTUAL VALUE FROM USER
+const industry = '[USER_INDUSTRY]'; // ASK USER (e.g., "Technology", "Software & Internet")
+
+// Click industry dropdown
+await page.getByRole('combobox', { name: /industry/i }).click();
+await page.waitForTimeout(1000);
+
+// Type industry name
+await page.keyboard.type(industry);
+await page.waitForTimeout(1000);
+
+// Select industry from dropdown
+await page.getByRole('option', { name: new RegExp(industry, 'i') }).click();
+await page.waitForTimeout(1000);
+```
+
+**Expected Result:** Industry is selected.
+
+---
+
+### Step 10: Select Role
+
+```javascript
+// Use user-provided role - REPLACE WITH ACTUAL VALUE FROM USER
+// Common options: "Entrepreneur", "Founder", "Co-Founder"
+const role = '[USER_ROLE]'; // ASK USER
+
+// Select role
+await page.getByRole('radio', { name: new RegExp(role, 'i') }).click();
+await page.waitForTimeout(500);
+```
+
+**Expected Result:** Role is selected.
+
+---
+
+### Step 11: Fill Additional Fields (If Present)
+
+```javascript
+// Fill any additional required fields that appear
+// Example: Business interest checkbox
+const businessInterest = page.getByRole('checkbox', { name: /business interest/i });
+if (await businessInterest.isVisible()) {
+  await businessInterest.check();
+  await page.waitForTimeout(500);
+}
+```
+
+---
+
+### Step 12: Handle Multi-Select Dropdowns (If Present)
+
+**For "What are the top 3 ways AWS can help you?":**
+```javascript
+// Click the multi-select dropdown
+await page.getByRole('combobox', { name: /ways AWS can help/i }).click();
+await page.waitForTimeout(1000);
+
+// Select first 3 options
+const options = await page.locator('[role="option"]').all();
+for (let i = 0; i < Math.min(3, options.length); i++) {
+  await options[i].click();
+  await page.waitForTimeout(500);
+}
+
+// Close dropdown by clicking outside or pressing Escape
+await page.keyboard.press('Escape');
+await page.waitForTimeout(500);
+```
+
+**For "Which AWS tech topics would you like to follow?":**
+```javascript
+// Click the multi-select dropdown
+await page.getByRole('combobox', { name: /tech topics/i }).click();
+await page.waitForTimeout(1000);
+
+// Select 3-5 relevant options (e.g., AI/ML, Compute, Storage)
+// ASK USER which topics they're interested in, or select common ones
+const relevantTopics = ['AI', 'Machine Learning', 'Compute', 'Storage', 'Database'];
+for (const topic of relevantTopics.slice(0, 3)) {
+  const option = page.getByRole('option', { name: new RegExp(topic, 'i') });
+  if (await option.isVisible()) {
+    await option.click();
+    await page.waitForTimeout(500);
+  }
+}
+
+await page.keyboard.press('Escape');
+await page.waitForTimeout(500);
+```
+
+**For "What type of customers do you primarily serve?":**
+```javascript
+// Click the multi-select dropdown
+await page.getByRole('combobox', { name: /customers|serve/i }).click();
+await page.waitForTimeout(1000);
+
+// ASK USER which customer types apply, or select relevant options
+const customerTypes = ['Enterprise', 'SMB', 'Startups'];
+for (const type of customerTypes.slice(0, 2)) {
+  const option = page.getByRole('option', { name: new RegExp(type, 'i') });
+  if (await option.isVisible()) {
+    await option.click();
+    await page.waitForTimeout(500);
+  }
+}
+
+await page.keyboard.press('Escape');
+await page.waitForTimeout(500);
+```
+
+---
+
+### Step 13: Click "Save and Continue"
+
+```javascript
+// Click save/continue button
+await page.getByRole('button', { name: /save.*continue|continue|next/i }).click();
+await page.waitForTimeout(3000);
+```
+
+**Expected Result:** Form validates and moves to next page or shows success message.
+
+---
+
+### Step 14: Handle Validation Errors (If Any)
+
+```javascript
+// Check for validation errors
+const errorMessages = await page.locator('[role="alert"], .error, [class*="error"]').all();
+if (errorMessages.length > 0) {
+  console.log('Validation errors found:');
+  for (const error of errorMessages) {
+    const text = await error.textContent();
+    console.log(`- ${text}`);
+  }
+  
+  // Fix errors and retry
+  // Example: If country/state/industry missing, repeat steps 7-9
+}
+```
+
+---
+
+### Step 15: Complete Remaining Pages (If Any)
+
+```javascript
+// If additional pages appear, continue filling them
+// Common additional pages:
+// - AWS Account linking
+// - Additional company details
+// - Terms and conditions
+
+// Example: Accept terms
+const termsCheckbox = page.getByRole('checkbox', { name: /terms|agreement/i });
+if (await termsCheckbox.isVisible()) {
+  await termsCheckbox.check();
+  await page.waitForTimeout(500);
+}
+
+// Example: Link AWS Account (if prompted)
+const linkAccountButton = page.getByRole('button', { name: /link.*account|connect/i });
+if (await linkAccountButton.isVisible()) {
+  // May require manual intervention
+  console.log('AWS Account linking required - may need manual step');
+}
+```
+
+---
+
+### Step 16: Submit Application
+
+```javascript
+// Click final submit button
+await page.getByRole('button', { name: /submit|finish|complete/i }).click();
+await page.waitForTimeout(5000);
+
+// Wait for confirmation page
+await page.waitForSelector('text=/success|submitted|thank you/i', { timeout: 10000 });
+```
+
+**Expected Result:** Application submitted successfully, confirmation page appears.
+
+---
+
+## Manual Steps (If Automation Fails)
+
+### Common Issues and Solutions
+
+1. **Dropdown Not Opening:**
+   - Try clicking the dropdown multiple times
+   - Use `page.evaluate()` to directly interact with DOM
+   - Try keyboard navigation (Tab, Enter, Arrow keys)
+
+2. **Element Not Found:**
+   - Wait longer for page to load
+   - Check if element is in iframe
+   - Use more generic selectors (e.g., `page.locator('input[type="text"]')`)
+
+3. **Validation Errors:**
+   - Ensure all required fields are filled
+   - Check field formats (phone numbers, emails)
+   - Verify dropdown selections are correct
+
+4. **AWS Account Linking:**
+   - May require manual intervention
+   - User may need to sign in to AWS account separately
+   - Follow on-screen instructions
+
+---
+
+## Verification
+
+### Check Application Status
+
+```javascript
+// Navigate to AWS Activate dashboard
+await page.goto('https://aws.amazon.com/startups/dashboard');
+await page.waitForTimeout(3000);
+
+// Check for application status
+const status = await page.locator('[class*="status"], [class*="application"]').textContent();
+console.log(`Application Status: ${status}`);
+```
+
+---
+
+## Expected Outcomes
+
+- **Application Submitted:** Confirmation page or email
+- **Processing Time:** 7-10 business days
+- **Approval Email:** Sent to registered email address
+- **Credits Added:** Automatically added to AWS account upon approval
+
+---
+
+## Troubleshooting
+
+### If Application Fails
+
+1. **Check Browser Console:**
+   ```javascript
+   // Log all console errors
+   page.on('console', msg => console.log('Browser console:', msg.text()));
+   ```
+
+2. **Take Screenshot:**
+   ```javascript
+   await page.screenshot({ path: 'aws-application-error.png', fullPage: true });
+   ```
+
+3. **Check Network Requests:**
+   ```javascript
+   page.on('response', response => {
+     if (response.status() >= 400) {
+       console.log(`Error: ${response.url()} - ${response.status()}`);
+     }
+   });
+   ```
+
+---
+
+## Next Steps After Submission
+
+1. **Monitor Email:** Check user's email for approval notification
+2. **Check AWS Console:** Verify credits appear in billing dashboard
+3. **Follow Up:** If no response after 10 business days, contact AWS support
+
+---
+
+## Resources
+
+- **AWS Activate Main Page:** https://aws.amazon.com/startups
+- **AWS Activate FAQ:** https://aws.amazon.com/activate/faq/
+- **AWS Support:** https://aws.amazon.com/support/
+
+---
+
+**Last Updated:** November 2025  
+**Status:** Ready for automation