🏗️ Project Structure

Overview

This section explains the organization of files and folders in the cypress-ai-automation repository to help you understand how the project is structured.

Root Directory Structure

cypress-ai-automation/
├── 📁 cypress/                 # Main testing framework
├── 📁 node_modules/            # NPM dependencies (auto-generated)
├── 📁 qa/                      # Documentation folder
├── 📄 .gitignore               # Git ignore patterns
├── 📄 cypress.config.js        # Cypress configuration
├── 📄 package.json            # Project metadata & scripts
└── 📄 package-lock.json       # Dependency lock file

Cypress Directory Structure

📁 /cypress/

The main testing framework directory:

cypress/
├── 📁 downloads/              # Files downloaded during tests
├── 📁 fixtures/               # Test data
├── 📁 integration/            # Test specification files
│   └── 📁 examples/           # AI website test cases
├── 📁 reports/                # Generated test reports
├── 📁 screenshots/            # Failure screenshots
├── 📁 support/                # Custom commands and utilities
└── 📁 videos/                 # Test execution recordings

📁 /cypress/integration/examples/

Contains the main test files:

examples/
├── 📄 AIWebsite.PublishedSite.test.js    # Frontend testing (597 lines)
└── 📄 AIWebsite.WP-Admin.test.js         # WordPress admin testing (321 lines)

What each file does:

• AIWebsite.PublishedSite.test.js: Tests the frontend of published AI websites
• AIWebsite.WP-Admin.test.js: Tests WordPress admin panel functionality

📁 /cypress/support/

Contains support files and custom commands:

support/
├── 📄 commands.js             # Custom Cypress commands
└── 📄 e2e.js                  # E2E test configuration

Key files:

• commands.js: Custom commands like handlePopups() for managing dynamic content
• e2e.js: Global configuration and imports for E2E testing

📁 /cypress/fixtures/

Test data storage:

fixtures/
└── 📄 example.json            # Sample test data structure

Configuration Files

📄 cypress.config.js

Main Cypress configuration file that contains:

• Timeouts: Extended timeouts for AI website testing
• Security: Chrome web security disabled for testing
• Reporting: Mochawesome reporter configuration
• File Patterns: Spec pattern for test discovery

📄 package.json

Project metadata containing:

• Dependencies: Cypress, mochawesome reporter, dotenv
• Scripts: Pre-defined commands for running tests
• Project Information: Name, version, description

Generated Directories

📁 /cypress/reports/

Auto-generated test reports:

• HTML Reports: Visual test results for viewing in browser
• JSON Reports: Machine-readable test data
• Assets: Screenshots and supporting files

📁 /cypress/screenshots/

Failure screenshots organized by:

• Test file name
• Timestamp
• Failure context

📁 /cypress/videos/

Test execution recordings (optional):

• Full test run videos
• Organized by test suite

File Naming Conventions

Test Files

• Pattern: [Component].[TestType].test.js
• Examples:
  • AIWebsite.PublishedSite.test.js
  • AIWebsite.WP-Admin.test.js

Support Files

• Pattern: [functionality].js
• Examples:
  • commands.js - Custom commands
  • e2e.js - E2E configuration