🤖 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

npm install page-object-assistant

🧪 Usage

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

Options:

| 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