🤖 Poa — Page Object Architecture Assistant

Poa is your friendly CLI tool for navigating, creating, and maintaining a clean, scalable Page Object structure in test automation projects.

---

🚀 Features

- ✅ Find page object by full URL
- ✅ Identify dynamic segments
- ✅ Create new page objects with clean structure
- ✅ Initialize in application class
- ✅ Automatically detect existing dynamic page files
- ✅ Config-free and intuitive

---

🛠 Installation

``bash
npm install page-object-assistant
`

---

🧪 Usage

`bash
npx poa find https://your-app.com/projects/123/users/456
`

$3

| Flag | Description |
|------|-------------|
| --app | Manually set app name |
| --create-page-object | Auto-create if missing |
| --open | Open file after creation |
| --editor | vscode, jetbrains, or default |
| --no-prompt | Skip confirmation prompts |
| --format | Output as json or plain |
| --output | Export info to file |
| --config | Custom config path |
| --create-app, --create-base-page-object, --init-page-in-app | Optional auto behaviors |

---

📁 Structure

Poa uses a folder-based routing pattern, just like modern front-end frameworks:

`
page-objects/
└── galaxy/
├── app.ts
└── projects/
└── [projectId]/
└── users/
└── [userId]/
└── page.ts
``

---

🔧 Philosophy

- ⚙️ No config required
- 👥 Team-friendly
- 🧠 Smart enough to assist
- 💡 Opinionated enough to enforce structure

---

📌 License

MIT