An open API service indexing awesome lists of open source software.

https://github.com/upex-galaxy/upex-dojo

UPEX Official App (next.js) for QA Web Test Automation
https://github.com/upex-galaxy/upex-dojo

Last synced: 7 months ago
JSON representation

UPEX Official App (next.js) for QA Web Test Automation

Awesome Lists containing this project

README

          

# UPEX DOJO: QA Automation Practice

![UPEX DOJO Logo](https://hebbkx1anhila5yf.public.blob.vercel-storage.com/dojo_ninja-QHGSv5kXbupUH9njcNAm7UAYY39rof.webp)

Welcome to **UPEX DOJO**, your ultimate QA Automation Basic Training Ground! This project is designed to help QA engineers practice and enhance their automation skills by interacting with a variety of web components and real-world scenarios.

## Table of Contents

- [Getting Started](#getting-started)
- [Prerequisites](#prerequisites)
- [Installation](#installation)
- [Running the App](#running-the-app)
- [Project Structure](#project-structure)
- [Available Components](#available-components)
- [Using the Website](#using-the-website)
- [Contributing](#contributing)
- [License](#license)

---

## Getting Started

Follow the steps below to get started with UPEX DOJO on your local machine.

### Prerequisites

Before you begin, ensure you have the following installed:
- **Node.js** (v14 or later)
- **npm** (v6 or later) or **yarn**

### Installation

1. **Clone the repository**:

```bash
git clone https://github.com/your-username/upex-dojo.git
cd upex-dojo
```

2. **Install dependencies**:

```bash
npm install
```

Or if you prefer **yarn**:

```bash
yarn
```

### Running the App

1. Start the development server:

```bash
npm run dev
```

Or with **yarn**:

```bash
yarn dev
```

2. Open your browser and navigate to: `http://localhost:3000`

---

## Project Structure

Here's an overview of the project's file and folder structure:

```bash
/public - Static assets (images, icons, etc.)
/components - Reusable React components
/pages - Next.js pages for each component and functionality
/styles - Global and component-specific styles
/utils - Helper functions and utilities
```

---

## Available Components

This project includes interactive components commonly used in web applications. Each component is isolated and ready for practice:

- **Buttons**: Click, double-click, right-click functionality.
- **Text Fields**: Input and validation scenarios.
- **Dropdown Menus**: Single and multi-select options.
- **Checkboxes**: Toggle states and group selection.
- **Radio Buttons**: Exclusive option selection.
- **Sliders**: Drag to set values.
- **Modals**: Open, close, and interact.
- **Tables**: Sorting, searching, and pagination.
- **File Uploads**: Upload validation and previews.
- **File Downloads**: Verify file download scenarios.
- **Drag-and-Drop**: Rearrange or move items.

---

## Using the Website

1. **Navigate to a component page**: Select a component from the home page.
2. **Plan your test scenarios**: Think about the test cases you'd write for the component using your favorite automation tool (e.g., Playwright, Cypress, Selenium).
3. **Practice**: Interact with the component and verify its behavior.
4. **Automate**: Use your preferred automation framework to write scripts for the test cases.

### Supported Frameworks

- **Playwright**
- **Cypress**
- **Selenium**
- **WebdriverIO**
- and more!

You can integrate these frameworks to write and execute your tests for the components.

---

## Contributing

We welcome contributions! Here's how you can help:

1. Fork the repository.
2. Create a new branch (`git checkout -b feature/your-feature-name`).
3. Commit your changes (`git commit -m 'Add your feature here'`).
4. Push to the branch (`git push origin feature/your-feature-name`).
5. Open a Pull Request.

---

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

---

## Contact

For questions or suggestions, feel free to reach out at [ely@upexgalaxy.com](mailto:ely@upexgalaxy.com).

---

Thank you for choosing **UPEX DOJO** to practice and enhance your QA Automation skills. Happy testing!