Examples

Bytesalt is an open-ended platform designed to be flexible to your specific requirements. While the core testing logic is autonomous, you can shape the agent’s behavior by providing specific requirements as inputs to your context or directly through test commands.

The following examples demonstrate some common use cases, but they are just a starting point for what you can achieve.

Setup

Before running any examples, set up your context once:

1. Create the context directory:

mkdir -p .bytesalt/context

2. Add context:

Create a file named .bytesalt/context/overview.md:

cat > .bytesalt/context/overview.md << 'EOF'
# Application
- Name: Acme Shop (staging)
- Type: E-commerce web app
- Purpose: Browse products, manage cart, and place orders
 
# Environment and access
- Base URL: https://staging.acmeshop.com
 
# Test account
- Email: test.user@acmeshop.com
- Password: Passw0rd!123
EOF

Example 1: Test the Entire Application

Run a comprehensive test by providing a broader task description:

bytesalt start "Test Acme Shop application"

This allows Bytesalt to autonomously explore and test multiple features across your application, including product browsing, cart management, checkout process, and more.

Example 2: Test Specific Features or Scenarios

Test specific features or run targeted audits by being precise with your task description. Bytesalt’s AI agents can automatically configure the browser, device, and environment based on your prompt. See the Environment documentation to learn more about the available environment capabilities.

Functional testing:

bytesalt start "Test login functionality"

Accessibility audit:

bytesalt start "Check Acme Shop for accessibility issues"

Security testing:

bytesalt start "Test for common security vulnerabilities in the checkout flow"

UI/UX & Design consistency:

bytesalt start "Audit the product page for UI/UX issues"

Cross-browser testing:

bytesalt start "Verify the header layout on Firefox and Edge"

Mobile & Tablet responsiveness:

bytesalt start "Test the mobile experience on iPhone 14 Pro"

Theme testing (Dark/Light mode):

bytesalt start "Verify the dashboard theme consistency in Dark Mode"

Internationalization (i18n):

bytesalt start "Test the homepage as if located in Tokyo with Japanese locale"

Example 3: Test on a Private Network

If your application is not publicly accessible (e.g., localhost, internal staging environment, or VPN-only access), use the --tunnel flag to securely expose it to Bytesalt.

Ensure your Base URL in .bytesalt/context/overview.md matches your environment.

For example:

• For localhost: - Base URL: http://localhost:3000
• For internal staging: - Base URL: https://staging.internal.acmeshop.com

Then run the test with the --tunnel flag:

bytesalt start "Test login functionality" --tunnel

Note: The --tunnel flag works for any non-publicly accessible environment:

• Localhost applications (e.g., http://localhost:3000)
• Internal staging servers on a private network
• VPN-protected environments

Learn more about tunneling in the Tunnel documentation.