Verify Your Setup

Let's run through a complete verification to ensure everything is configured correctly before we start building our first project.

Complete Verification Checklist

Open PowerShell and run each command. Check that your output matches the expected results.

1. Node.js and npm

2. Git

Check your Git configuration:

3. AWS CLI

Verify your AWS credentials are configured:

{
    "UserId": "AIDA...",
    "Account": "123456789012",
    "Arn": "arn:aws:iam::123456789012:user/amplify-dev"
}

4. Amplify CLI

5. VS Code (Optional)

Quick Test: Create a Nuxt App

Let's verify everything works together by creating a quick test project:

1. Create a test directory
   mkdir C:\temp\amplify-test; cd C:\temp\amplify-test
2. Initialize a new Nuxt project
   npx nuxi@latest init test-app

   When prompted, choose the default options. This may take a minute.

3. Enter the project and install dependencies
   cd test-app; npm install
4. Start the development server
   npm run dev

   You should see output like:

   Nuxt 3.x.x with Nitro 2.x.x
     ➜ Local:    http://localhost:3000/
     ➜ Network:  http://192.168.x.x:3000/

5. Open in browser

   Navigate to http://localhost:3000. You should see the Nuxt welcome page!

6. Stop the server

   Press Ctrl+C in the terminal to stop the dev server.

Environment Summary Script

Here's a PowerShell script that checks everything at once. Save it as check-env.ps1 and run it:

# check-env.ps1 - Verify Amplify development environment

Write-Host "========================================" -ForegroundColor Cyan
Write-Host "  AWS Amplify Environment Check" -ForegroundColor Cyan
Write-Host "========================================" -ForegroundColor Cyan
Write-Host ""

# Node.js
Write-Host "Node.js: " -NoNewline
try {
    $nodeVersion = node --version
    Write-Host $nodeVersion -ForegroundColor Green
} catch {
    Write-Host "NOT INSTALLED" -ForegroundColor Red
}

# npm
Write-Host "npm: " -NoNewline
try {
    $npmVersion = npm --version
    Write-Host $npmVersion -ForegroundColor Green
} catch {
    Write-Host "NOT INSTALLED" -ForegroundColor Red
}

# Git
Write-Host "Git: " -NoNewline
try {
    $gitVersion = git --version
    Write-Host $gitVersion -ForegroundColor Green
} catch {
    Write-Host "NOT INSTALLED" -ForegroundColor Red
}

# AWS CLI
Write-Host "AWS CLI: " -NoNewline
try {
    $awsVersion = aws --version 2>&1
    Write-Host $awsVersion -ForegroundColor Green
} catch {
    Write-Host "NOT INSTALLED" -ForegroundColor Red
}

# AWS Credentials
Write-Host "AWS Credentials: " -NoNewline
try {
    $identity = aws sts get-caller-identity 2>&1 | ConvertFrom-Json
    Write-Host "Configured (Account: $($identity.Account))" -ForegroundColor Green
} catch {
    Write-Host "NOT CONFIGURED" -ForegroundColor Red
}

# Amplify CLI
Write-Host "Amplify CLI: " -NoNewline
try {
    $ampxVersion = npx ampx --version 2>&1
    Write-Host $ampxVersion -ForegroundColor Green
} catch {
    Write-Host "Error checking" -ForegroundColor Yellow
}

Write-Host ""
Write-Host "========================================" -ForegroundColor Cyan
Write-Host "  Check Complete!" -ForegroundColor Cyan
Write-Host "========================================" -ForegroundColor Cyan

Common Issues and Solutions

Issue: "node" is not recognized

Solution: Restart PowerShell after installing Node.js, or check that Node.js is in your PATH environment variable.

Issue: AWS credentials not working

Solution:

1. Run aws configure and re-enter your access keys
2. Make sure there are no typos in the access key or secret
3. Verify the IAM user has the AdministratorAccess-Amplify policy

Issue: npx ampx hangs or times out

Solution:

1. Check your internet connection
2. Try clearing npm cache: npm cache clean --force
3. If behind a corporate proxy, configure npm proxy settings

Issue: Port 3000 already in use

Solution: Another application is using port 3000. Either stop that application or run Nuxt on a different port:

Module 2 Complete!

In the next module, we'll create your first Amplify project and explore the project structure in detail!