This application (called 🦎 GAD) was prepared and developed only for testing purposes. It provides:
- A graphical user interface (GUI)
- REST API
- Integrated Swagger documentation
The application includes features such as simple logic, statistics, charts, games, and various resources. It is intentionally designed with deliberately bugs🐛 and challenges to simulate real-world project complexities.
🦎 GAD is ideal for learning test automation, refining QA techniques, and practicing with scenarios encountered in diverse, real-world projects with diverse real-world scenarios.
P.S. In addition, the application has some serious design flaws - I wonder if you will notice them?😉
Important
Want to quickly test the application?
- clone or download the repository
- run
npm i - run
npm run start - open http://localhost:3000 in your browser
- enjoy testing and automating 🦎 GAD!
Features of 🦎 GAD:
- GUI (front-end)
- REST API and WebSockets (back-end)
- Two Application Domains:
- Testers Blog
- Resources - Articles, Users, Comments, and more
- Functionalities - Likes, Comments, Tags, and user engagement tools
- Insights - Statistics and charts (e.g., likes per user, comments per article)
- Authentication and Authorization
- Practice pages
- A collection of pages featuring automation challenges, such as:
- Iframes
- File uploads
- Drag-and-drop
- Dynamic elements
- Likes, labels, and surveys
- Banners, pop-ups, front-end, and back-end logic
- Games and more!
- A collection of pages featuring automation challenges, such as:
- Testers Blog
- Swagger Documentation - API documentation for seamless integration
- Simple Database - JSON-based database with REST API endpoints for clearing/restoring data
- Various Data Sets - Small, medium, and large datasets to simulate real-world scenarios
- Dynamic Configuration - Adjust application settings easily from the UI
- Feature Flags - Enable or disable features
- Bug Flags - Introduce or remove bugs for testing purposes
- Different data presentation (charts, tables etc.)
- Challenging elements for test automation (iframes, file uploads, drag&drop, 2 factor authentication, labels, surveys, banners, pop-ups, logic on front-end and back-end, dynamic elements, games etc.)
- Admins' Backoffice: Includes advanced functionalities such as:
- Database reset
- SQL playground for experimenting and testing queries
Instructions how to deploy presented service to various free hosting sites.
Requirements:
- node.js installed in the system
- tested on node.js v20 and v22
- git installed in the system
Steps:
- Open the project root directory in cmd/terminal
- Clone the repository using
git clone ...- this is the preferred way to use this application
- Run
npm i- to install modules (don't use node.js global packages!)
- Run
npm run start- to start GAD
The application will be available at http://localhost:3000
Steps:
- Download zipped repository
- Unzip and replace Your local instance of GAD
- Run
npm iin root directory- to install new modules
- Run
npm run start- to start GAD
Steps:
- Open the project root directory in cmd/terminal
- Pull latest changes using
git pull - Run
npm i- to install new modules
- Run
npm run start- to start GAD
One possibility is to reset all Your local changes and pull new version.Using this method You will lose all Your local changes and data!
Steps:
- Open the project root directory in cmd/terminal
- Reset local changes and pull latest changes using:
git reset --hard HEAD git pull - Run
npm i- to install new modules
- Run
npm run start- to start GAD
Tip
CLI (Command Line Interface) is an interface that allows you to interact with the application using commands in the terminal.
| Option | Description |
|---|---|
| READ_ONLY=1 | Run in Read Only mode. This disables all POST, PUT, and PATCH methods, besides login. |
| PORT=3001 | Run on selected port. GAD runs on default port 3000. |
| DB="db_name" | Use selected database file. GAD uses db.json as default database. Example (for PowerShell): $env:DB="db-base-big"; npm run start |
Warning
To run GAD with CLI options, use the following commands e.g.:
PowerShell:
$env:PORT=3001; npm run startBash:
PORT=3001 npm run startWindows Cmd:
set PORT=3001 && npm run start
Render - a popular Heroku-like PaaS with a free tier and a “Deploy to Render” button for one-click deploys.
- Create free account on: https://dashboard.render.com/register
- After successful registration hit the button:
- name your app
- hit
Apply - wait a while and click link to project
GUI API Demo - click link to open app (under project name and repository)
- enjoy 750 free hours of service per month
When deploying the GAD application on Render, please be aware that the application may not function fully due to the limitations of the Render platform. However, we are making every effort to ensure the highest possible compatibility.
This method can be used:
- locally
- in CI/CD services (GitHub Actions, GitLab CI etc.)
On local environment:
- latest Docker is installed
Just run following command to get latest image:
docker run -p 3000:3000 -d jaktestowac/gad
or specific version:
docker run -p 3000:3000 -d jaktestowac/gad:2.5.5
Application should be running under http://localhost:3000/
Images are available at: 🐋 https://hub.docker.com/r/jaktestowac/gad
Warning
Glitch has changed their platform policies and this deployment method may no longer work as expected. Please use one of the other deployment methods instead.
No account needed - but your project will be deleted in 5 days.
After clicking button below wait a minute or two to finish deployment.
To see website:
- go to bottom buttons
- click
🔎PREVIEW- choose 👯Preview in a new window
When deploying the GAD application on Glitch, please be aware that the application may not function fully due to the limitations of the Glitch platform. However, we are making every effort to ensure the highest possible compatibility.
We hope you'll have a great time testing and automating this application!
The challenges and features included are designed to help you grow your testing skills while having fun.
If you have any ideas for improvements or encounter any issues, please don't hesitate to open an issue on our GitHub repository.
Your feedback helps make GAD better for everyone!
📢 Looking forward to your contributions and happy testing!🦎
Feel free to reach out to us:
- 🌐 Website: jaktestowac.pl
- 💼 LinkedIn: jaktestowac.pl
- 💬 Discord: Polish Playwright Community
- 📧 Support: Check our website for contact details
- 🐛 Issues: GitHub Issues
We have gathered a collection of resources to help you learn and master Playwright, both in Polish and English. Whether you're a beginner or an advanced user, these resources will help you enhance your skills and knowledge.
- TypeScript for Testers - Express Introduction - Free (4h+) course on TypeScript for Testers
- JavaScript and TypeScript for Testers - Comprehensive (13h+) course on JavaScript and TypeScript for testers, with practical examples and exercises
- Professional Test Automation with Playwright - Comprehensive (100h+) course on Playwright, test automation, CI/CD and test architecture
- Back-end Test Automation - Comprehensive (45h+) course on Back-end Test Automation with Postman, Mocha, Chai, and Supertest
- Free Playwright Resources - Comprehensive and Free Polish learning materials
- Playwright Basics - YouTube series (Polish)
- Playwright Elements - Advanced concepts (Polish)
- Playwright MCP - MCP course (Polish)
- Discord Community - First Polish Playwright community!
- Playwright Info - first and only Polish Playwright blog
Gain an edge by combining AI knowledge with the most popular tools in the IT market.
We'll show you how to accelerate with AI and build a professional test automation framework. 😉
- AI_Testers - Main page about AI_Testers Program
- AI_Testers LinkedIn - Follow us on LinkedIn
- VS Code Extensions - Our free Playwright plugins
PS. For more resources and updates, follow us on our website and GitHub.
Powered by jaktestowac.pl team! 💚❤️
