Skip to content

Latest commit

 

History

History
73 lines (47 loc) · 3.01 KB

README.md

File metadata and controls

73 lines (47 loc) · 3.01 KB

🏃‍♂️ StepRunner

Build Deploy License

StepRunner bridges the gap between automated and manual testing by seamlessly blending both approaches.

Perfect for QA engineers, testers, and developers who need to execute BDD scenarios step-by-step, import existing Cucumber automation results, attach visual evidence, and generate unified reports that combine automated test outcomes with manual verification.

✨ Key Features

  • 📂 File Upload: Support for .feature files and Cucumber JSON reports
  • 🧾 Smart Display: Beautiful rendering of features, scenarios, steps, backgrounds, and examples
  • ✅ Interactive Execution: Mark steps as passed/failed/skipped/undefined individually or in bulk
  • 📸 Visual Evidence: Drag-and-drop image attachments for any step
  • 📊 Rich Reporting: Export results as Cucumber JSON and browsable HTML reports
  • 🔄 Hybrid Workflows: Import automated results and continue with manual steps
  • 🔒 Privacy-First: No data leaves your browser unless you choose to export
  • 🎨 Intuitive UI: Clean, modern interface designed for testing workflows
  • 📱 Mobile Friendly: Works seamlessly on desktop, tablet, and mobile devices

📸 Screenshots & Demo

StepRunner interface showing Cucumber feature file execution

StepRunner interface showing step-by-step execution of a Cucumber feature file with visual feedback

🌐 Live Demo: https://steprunner-abc1f.web.app/

🧠 How It Works

  1. Upload: Start a new session and upload .feature files or a cucumber-report.json
  2. Browse: Navigate through features, scenarios, and steps via the intuitive UI
  3. Execute: Mark steps as passed/failed/skipped as you execute tests manually
  4. Document: Drag and drop screenshots onto steps for visual evidence
  5. Export: Generate comprehensive JSON and HTML reports for sharing

🚀 Getting Started

Prerequisites

  • Node.js (>= 18)
  • npm

Installation & Development

# Clone the repository
git clone https://github.com/steveswinsburg/steprunner.git
cd steprunner

# Install dependencies
npm install

# Start development server
npm start

# Open http://localhost:3000 in your browser

🤝 Contributing

See CONTRIBUTING.md

📄 License

This project is licensed under the Business Source License 1.1 (BUSL-1.1). Production use requires a commercial license from the Licensor. See LICENSE for details.

For commercial licensing, please contact: steve.swinsburg@gmail.com

Made with ❤️ for the testing community