README

Welcome to the complete documentation for TrueAssert - your guide to intelligent web testing automation.

---

🚀 Quick Start

New to TrueAssert? Start here:

1. Create Your Account - Sign up and get started

2. Install Browser Plugin - Set up the Chrome extension

3. Create Your First Test - Build a test in 5 minutes

→ Complete Getting Started Guide

---

📚 Documentation Sections

Getting Started ✅

Essential guides for new users (all based on actual implementation):

• Account Setup - Create account, automatic organization/project setup

• Installation - Browser plugin installation and API key creation

• Core Concepts - TrueAssert architecture and fundamentals

• Your First Test - Create tests via recording, AI, or manual methods

Guides

Creating Tests:

• Browser Plugin Recording - Record interactions to generate tests

• AI Test Generation - Create tests from natural language

• Manual Test Creation - Build tests using the web interface

Test Execution:

• Running Tests - Execute and monitor test runs

• Viewing Results - Understand test execution results

• Debugging Failed Tests - Troubleshoot and fix test failures

Session Management:

• Setting Up Login - Configure authentication flows

• Session Validation - Understand session reuse

• Per-Domain Sessions - Manage sessions across domains

Selectors & Elements:

• Understanding XPath Selectors - How smart selectors work

• Selector Best Practices - Tips for reliable selectors

• Troubleshooting Selectors - Fix selector issues

Tutorials

Step-by-step guides for real-world scenarios:

• Testing a Login Flow - Complete authentication testing

• E-commerce Checkout Testing - Test shopping cart flows

• Form Submission Testing - Validate form interactions

• Multi-Step Workflow Testing - Complex scenario testing

Advanced Topics

For power users and integrations:

• Test Organization - Projects, teams, and structure

• Performance Optimization - Speed up your test suite

📢 API in Development: We're currently working on a REST API for programmatic integration into your CI/CD pipelines. Stay tuned for updates!

Reference

Quick lookup guides:

• Command Reference - All available test commands

• Selector Types - XPath and CSS selector syntax

• Error Codes - Understanding error messages

---

🎯 Learning Paths

Choose your path based on your role:

For QA Engineers

1. Account Setup

2. Browser Plugin Recording

3. Running Tests

4. Debugging Failed Tests

5. Selector Best Practices

For Developers

1. Account Setup

2. AI Test Generation

3. Test Organization

4. Performance Optimization

5. Advanced Topics

For Test Automation Teams

1. Core Concepts

2. Session Management

3. Test Organization

4. Performance Optimization

5. All Tutorials

---

🔍 Common Tasks

Quick links to frequently needed information:

• How do I create a test? → Browser Plugin Recording or AI Test Generation

• How do I set up login? → Setting Up Login

• My test is failing, why? → Debugging Failed Tests

• Selectors keep breaking → Troubleshooting Selectors

---

📖 Related Resources

• Help Center - FAQs, troubleshooting, and support

• Changelog - Latest updates and new features

---

💡 Tips for Success

• Start Simple: Begin with browser plugin recording before exploring AI generation

• Use Session Management: Set up login flows early to save time on authentication

• Review Generated Selectors: Check that XPath selectors are stable before running tests

• Organize Your Tests: Use projects and proper naming conventions from the start

• Check Execution Logs: Screenshots and logs help debug issues quickly

---

🆘 Need Help?

• Stuck? Check the Help Center for common questions

• Can't find what you need? Use the search function (top right)

• Looking for more information? Browse our complete documentation