chore: fix readme and add new run command

Author: AlexAlexandreAlves

README.md

@@ -1,68 +1,68 @@
 # Page Object Model (POM) Pattern
 
-Este projeto é uma suíte de testes automatizados utilizando [Playwright](https://playwright.dev/) para validar fluxos de autenticação e cadastro em uma aplicação web. O projeto adota o padrão **Page Object Model (POM)** para organizar e simplificar a interação com as páginas, tornando os testes mais legíveis, reutilizáveis e de fácil manutenção.
+This project is an automated test suite using [Playwright](https://playwright.dev/) to validate authentication and registration flows in a web application. The project adopts the **Page Object Model (POM)** pattern to organize and simplify page interactions, making tests more readable, reusable, and easy to maintain.
 
-## Contexto
+## Context
 
-O objetivo deste repositório é demonstrar como estruturar testes automatizados de ponta a ponta (E2E) utilizando o padrão de projeto **Page Object Model**. Esse padrão encapsula operações e elementos de cada página em classes específicas, expondo métodos de alto nível para os testes, sem que eles precisem conhecer detalhes de implementação dos elementos da interface.
+The purpose of this repository is to demonstrate how to structure end-to-end (E2E) automated tests using the **Page Object Model** design pattern. This pattern encapsulates operations and elements of each page in specific classes, exposing high-level methods for the tests, so they do not need to know implementation details of the UI elements.
 
-## Sobre o Page Object Model
+## About the Page Object Model
 
-O **Page Object Model (POM)** é um padrão de design que promove a criação de classes para cada página da aplicação, centralizando os seletores e ações em um único local. Isso facilita a manutenção dos testes, pois mudanças na interface exigem alterações apenas nos objetos de página correspondentes.
+The **Page Object Model (POM)** is a design pattern that promotes the creation of classes for each application page, centralizing selectors and actions in a single location. This makes test maintenance easier, as UI changes require updates only in the corresponding page objects.
 
-**Exemplo:**
+**Example:**
 ```typescript
 const loginPage = new LoginPage(page);
 await loginPage.login("email@teste.com", "senha");
 ```
 
-## Estrutura do Projeto
+## Project Structure
 
-- `ui/pages/`: Page Objects com os elementos e ações de cada página.
-- `tests/`: Arquivos de teste automatizados.
-- `playwright.config.ts`: Configuração do Playwright (incluindo baseURL).
+- `ui/pages/`: Page Objects with elements and actions for each page.
+- `tests/`: Automated test files.
+- `playwright.config.ts`: Playwright configuration (including baseURL).
 
-## Comandos Essenciais
+## Essential Commands
 
-- **Executar todos os testes:**
+- **Run all tests:**
   ```
   npx playwright test
   ```
 
-- **Executar testes em modo UI interativo:**
+- **Run tests in interactive UI mode:**
   ```
   npx playwright test --ui
   ```
 
-- **Executar testes em um navegador específico:**
+- **Run tests in a specific browser:**
   ```
   npx playwright test --project=chromium
   ```
 
-- **Executar um arquivo de teste específico:**
+- **Run a specific test file:**
   ```
   npx playwright test tests/login.test.ts
   ```
 
-- **Executar em modo debug:**
+- **Run in debug mode:**
   ```
   npx playwright test --debug
   ```
 
-- **Gerar testes automaticamente com Codegen:**
+- **Generate tests automatically with Codegen:**
   ```
   npx playwright codegen
   ```
 
-## Requisitos
+## Requirements
 
-- Node.js instalado
-- Dependências instaladas com:
+- Node at least v18 installed
+- Dependencies installed with:
   ```
-  npm install
+  npm run setup
   ```
 
-## Observações
+## Notes
 
-- O projeto utiliza `baseURL` configurado no `playwright.config.ts`, permitindo o uso de caminhos relativos nos testes.
-- Como a aplicação de exemplo não possui banco de dados persistente, os dados criados existem apenas durante a sessão.
+- The project uses `baseURL` configured in `playwright.config.ts`, allowing the use of relative paths in tests.
+- As the sample application does not have a persistent database, created data exists only during the session.

package.json

@@ -3,11 +3,13 @@
   "version": "1.0.0",
   "description": "automation test patterns",
   "main": "index.js",
-  "scripts": {},
+  "scripts": {
+    "setup": "npm install && npx playwright install"
+  },
   "author": "Alex Alexandre Alves",
   "license": "ISC",
   "devDependencies": {
     "@playwright/test": "^1.54.0",
     "@types/node": "^24.0.13"
   }
-}
+}