Skip to content

TINAA Resources Framework

This document provides comprehensive documentation for TINAA's extended resources framework, which includes 25 specialized resources following the gofastmcp.com v2.8.0 specification.

Overview

The resources framework provides ready-to-use tools, templates, examples, and AI prompts to accelerate Playwright test automation development. All resources are organized in a structured hierarchy and accessible through the resource index at /resources/index.json.

Resource Categories

🛠️ Tools (9 resources)

CLI Tools

  • playwright-installer (/resources/tools/cli/install.json)
  • Automated Playwright installation and setup
  • Browser management and configuration

  • Environment validation

  • test-runner (/resources/tools/cli/test-runner.json)

  • Advanced test runner with custom options
  • Parallel execution strategies
  • Report generation and filtering

Project Scaffolding

  • pom-generator (/resources/tools/scaffolding/pom-generator.json)
  • Page Object Model generator with templates
  • Automatic class generation from URLs

  • Best practice enforcement

  • project-init (/resources/tools/scaffolding/project-init.json)

  • Initialize new Playwright projects
  • Directory structure creation
  • Configuration file templates

CI/CD Integration

  • ci-setup (/resources/tools/ci/setup.json)
  • GitHub Actions, Jenkins, GitLab CI configurations
  • Docker integration
  • Test result reporting

Visual Testing

  • percy-integration (/resources/tools/visual-testing/percy.json)
  • Percy visual testing integration
  • Snapshot management

  • Cross-browser visual comparison

  • screenshot-diff (/resources/tools/visual-testing/screenshot-diff.json)

  • Native screenshot comparison tools
  • Pixel-perfect difference detection
  • Threshold configuration

Debugging & Trace

  • trace-viewer (/resources/tools/trace/viewer.json)
  • Trace recording and viewing utilities
  • Timeline analysis
  • Network request inspection

State Management

  • storage-state (/resources/tools/state-management/storage-state.json)
  • Authentication state management
  • Session persistence
  • Multi-user testing support

🚀 Quickstarts (4 resources)

  • web-basic (/resources/quickstarts/web/basic.json)
  • Basic web testing setup and examples
  • Element interaction patterns

  • Navigation and assertion basics

  • mobile-web (/resources/quickstarts/mobile/mobile-web.json)

  • Mobile device emulation
  • Touch interactions

  • Responsive design testing

  • api-testing (/resources/quickstarts/api/api-testing.json)

  • REST API testing with Playwright
  • Request/response validation

  • Authentication handling

  • e2e-api-hybrid (/resources/quickstarts/hybrid/e2e-api.json)

  • Combined UI and API testing strategies
  • Data setup via API
  • UI validation workflows

📘 Examples (4 resources)

  • standard-login (/resources/examples/login/standard-login.json)
  • Common login patterns
  • Multi-factor authentication

  • Session management

  • crud-forms (/resources/examples/crud/form-testing.json)

  • Create, Read, Update, Delete operations
  • Form validation testing

  • Data persistence verification

  • shopping-cart (/resources/examples/shopping/cart-checkout.json)

  • E-commerce workflows
  • Cart manipulation

  • Checkout process automation

  • analytics-dashboard (/resources/examples/dashboard/analytics-dashboard.json)

  • Data visualization testing
  • Chart interaction
  • Dashboard responsiveness

📚 Documentation (3 resources)

  • best-practices (/resources/docs/best-practices.json)
  • Playwright testing best practices
  • Code organization patterns

  • Performance optimization

  • troubleshooting (/resources/docs/troubleshooting.json)

  • Common issues and solutions
  • Debugging strategies

  • Environment-specific fixes

  • design-patterns (/resources/docs/patterns.json)

  • Test automation design patterns
  • Architecture guidelines
  • Scalability considerations

🤖 AI Prompts (3 resources)

  • test-generator (/resources/prompts/test-generator.json)
  • Generate Playwright tests from requirements
  • Natural language to test code conversion

  • Test case expansion and optimization

  • code-reviewer (/resources/prompts/code-reviewer.json)

  • Automated code quality analysis
  • Best practice enforcement

  • Performance optimization suggestions

  • debug-assistant (/resources/prompts/debug-assistant.json)

  • Intelligent error analysis
  • Root cause identification
  • Solution recommendations

📊 Additional Resources (2 resources)

  • Resource Index (/resources/index.json)
  • Central registry of all resources
  • Metadata and categorization

  • Version tracking

  • Testing Strategies (/resources/testing_strategies.json)

  • Comprehensive testing methodologies
  • Risk-based testing approaches
  • Coverage strategies

Using Resources

Accessing Resources

All resources are accessible through the TINAA HTTP API:

# Get resource index
curl http://localhost:8765/resources/index.json

# Get specific resource
curl http://localhost:8765/resources/tools/cli/install.json

# Get AI prompts
curl http://localhost:8765/resources/prompts/test-generator.json

Resource Structure

Each resource follows a consistent JSON structure:

{
  "id": "unique-identifier",
  "name": "Human-readable name",
  "description": "What this resource does",
  "type": "resource-type",
  "version": "1.0.0",
  "framework": "gofastmcp.com v2.8.0",
  "content": {
    // Resource-specific content
  }
}

Integration Examples

Using CLI Tools

import requests

# Get Playwright installer resource
installer = requests.get("http://localhost:8765/resources/tools/cli/install.json").json()

# Execute installation commands
for command in installer["content"]["commands"]:
    subprocess.run(command, shell=True)

Using Test Execution Prompts

# Get test generator prompt
prompt_resource = requests.get("http://localhost:8765/resources/prompts/test-generator.json").json()

# Use with AI to generate tests
test_prompt = prompt_resource["content"]["prompts"]["generate_from_requirements"]
# Feed to AI with your requirements

Using Examples as Templates

# Get login example
login_example = requests.get("http://localhost:8765/resources/examples/login/standard-login.json").json()

# Use as template for your login tests
test_template = login_example["content"]["test_patterns"]["standard_login"]

Resource Development

Adding New Resources

  1. Create the resource JSON file in the appropriate category directory
  2. Follow the standard resource structure
  3. Add entry to /resources/index.json
  4. Update category documentation

Resource Guidelines

  • Consistency: Follow established naming conventions
  • Documentation: Include clear descriptions and examples
  • Versioning: Use semantic versioning for resources
  • Testing: Validate resources before inclusion

Resource Metadata

Framework Compliance

All resources comply with the gofastmcp.com v2.8.0 framework specification, ensuring: - Standardized structure - Interoperability - Version compatibility - Quality assurance

Categories and Tags

Resources are categorized and tagged for easy discovery: - Type: tool, quickstart, example, documentation, prompt - Technology: playwright, browser, testing, automation - Complexity: beginner, intermediate, advanced - Domain: web, mobile, api, security, accessibility

Contributing

To contribute new resources:

  1. Follow the resource structure guidelines
  2. Include comprehensive documentation
  3. Add appropriate examples and usage instructions
  4. Test the resource thoroughly
  5. Submit via pull request with updated index

Support

For resource-related issues: - Check the troubleshooting documentation - Review existing issues in the repository - Create detailed bug reports with resource references - Suggest improvements through feature requests