{"id":27221194,"url":"https://github.com/jonnymiller99/page-language-model","last_synced_at":"2026-05-06T02:39:31.628Z","repository":{"id":287114482,"uuid":"963643750","full_name":"JonnyMiller99/page-language-model","owner":"JonnyMiller99","description":"Open-source framework for defining Page Language Models (PLMs) for intelligent app understanding and AI-assisted testing.","archived":false,"fork":false,"pushed_at":"2025-04-10T02:36:48.000Z","size":8,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-10T03:24:14.930Z","etag":null,"topics":["automation","developer-tools","json-schema","llm","manual-testing","open-source","page-language-model","page-object-model","playwright","plm","pom","selenium","test-automation","test-driven-development","testing","testing-framework","testing-tools","ui-testing"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JonnyMiller99.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-04-10T02:01:36.000Z","updated_at":"2025-04-10T02:48:48.000Z","dependencies_parsed_at":"2025-04-10T03:24:25.206Z","dependency_job_id":"039eb6bc-f233-46ec-9c52-785d3796f936","html_url":"https://github.com/JonnyMiller99/page-language-model","commit_stats":null,"previous_names":["jonnymiller99/page-language-model"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JonnyMiller99%2Fpage-language-model","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JonnyMiller99%2Fpage-language-model/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JonnyMiller99%2Fpage-language-model/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JonnyMiller99%2Fpage-language-model/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JonnyMiller99","download_url":"https://codeload.github.com/JonnyMiller99/page-language-model/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248173941,"owners_count":21059611,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","developer-tools","json-schema","llm","manual-testing","open-source","page-language-model","page-object-model","playwright","plm","pom","selenium","test-automation","test-driven-development","testing","testing-framework","testing-tools","ui-testing"],"created_at":"2025-04-10T07:21:30.450Z","updated_at":"2026-05-06T02:39:31.622Z","avatar_url":"https://github.com/JonnyMiller99.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📄 Page Language Model (PLM)\n\n**Page Language Model (PLM)** is a new open-source format for describing the structure, behavior, and flow of pages in web and mobile applications — designed specifically for **AI-assisted testing, automation, and reasoning**.\n\nIt combines the familiar **Page Object Model (POM)** with the power of **Large Language Models (LLMs)** to give intelligent agents a structured, machine-readable understanding of your app.\n\n---\n\n## 🔍 Why PLM?\n\nModern apps can be too complex to test with raw selectors and brittle flows.\n\nPLM solves this by providing:\n\n- 🔗 **Linked page flows** (what pages connect to what)\n- 🔘 **Detailed component maps** (inputs, buttons, modals, etc.)\n- ✅ **Validation and requirement rules**\n- 🧠 **AI-ready format** for test generation, analysis, and understanding\n\nIt's declarative, JSON-based, and version-controlled — built for developers, testers, and LLM-powered tools.\n\nPLMs also support rich metadata like `description`, `intent`, `exampleInput`, and `llmHint` to help LLMs understand the role and behavior of each component.\n\n---\n\n## 🧠 What Does a PLM Look Like?\n\nHere’s a basic example for a login page, using both structural fields and LLM-aware metadata:\n\n```json\n{\n  \"page\": \"LoginPage\",\n  \"url\": \"/login\",\n  \"components\": [\n    {\n      \"id\": \"emailInput\",\n      \"type\": \"input\",\n      \"label\": \"Email\",\n      \"required\": true,\n      \"validation\": \"must be a valid email\",\n      \"exampleInput\": \"jon@example.com\",\n      \"description\": \"User's login email address\",\n      \"intent\": \"Capture the user's email for login\"\n    },\n    {\n      \"id\": \"passwordInput\",\n      \"type\": \"input\",\n      \"label\": \"Password\",\n      \"required\": true,\n      \"validation\": \"minimum 8 characters\",\n      \"exampleInput\": \"securepass123\",\n      \"description\": \"User's password\",\n      \"intent\": \"Collect secure password input\"\n    },\n    {\n      \"id\": \"loginButton\",\n      \"type\": \"button\",\n      \"label\": \"Log In\",\n      \"action\": \"submitLoginForm\",\n      \"transitionsTo\": \"DashboardPage\",\n      \"llmHint\": \"Only enable after email and password fields are filled and valid\",\n      \"description\": \"Submits login credentials and redirects on success\"\n    }\n  ]\n}\n```\n\n👉 See [`examples/login-page.json`](examples/login-page.json) for a full example.\n\n---\n\n## 🧱 What’s in This Repo?\n\n- `schema/plm.schema.json` – the official v0.2 PLM JSON schema\n- `examples/` – sample pages to learn from and fork\n- `docs/` – deeper guides and best practices\n- `cli/` – (coming soon) CLI tools for working with PLM files\n\n---\n\n## 🚀 Coming Soon\n\n- CLI to validate and scaffold PLMs\n- PLM → test case generators (Cypress, Playwright, etc.)\n- Visual editor + LLM agent integrations\n\n---\n\n## ✨ Origin\n\nPLM was created in 2025 by Jonathan Miller as a new standard to bridge the gap between UI automation, manual testing and AI reasoning.\n\n\u003e \"Don't just test your UI — help AI understand it.\"\n\n---\n\n## 🤝 Want to Help?\n\n- ⭐ Star the repo to follow along\n- 📂 Try building your own PLM files\n- 📣 Open issues or discussions\n- 🧠 Spread the word and help define the standard\n\n---\n\n👉 See [`docs/README.md`](docs/README.md) for the full PLM spec and advanced usage.\n\n---\n\n## 📜 License\n\nMIT License — free to use, modify, and build on.  \nIf you're interested in contributing, collaborating, or helping shape this standard, [get in touch](https://github.com/JonnyMiller99).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonnymiller99%2Fpage-language-model","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjonnymiller99%2Fpage-language-model","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonnymiller99%2Fpage-language-model/lists"}