# PHPue AI Knowledge

> The companion AI knowledge base for PHPue 0.0.3, with coding-agent rules, verified examples and downloadable skills. Official framework documentation: https://phpue.co.uk/docs.

PHPue is NOT Vue: .pvue files compile to plain PHP on the server; there is no virtual DOM, reactivity, props, slots or hydration. Current release: PHPue 0.0.3 (needs PHP 8.0+). Official site: https://phpue.co.uk. Source: https://github.com/PHPue/PHPue.

Read `ai-rules` before writing code. Every topic is self-contained markdown; `/llms-full.txt` is all of them in one file.

## Start here

- [What PHPue is (and is not)](https://ai.phpue.co.uk/knowledge/overview.md): Definition, mental model, requirements, project layout and the request lifecycle of PHPue 0.0.3.
- [Rules for AI coding agents](https://ai.phpue.co.uk/knowledge/ai-rules.md): The hard rules, the things never to bring in from Vue/React/Blade, the verification workflow, and an AGENTS.md / CLAUDE.md to drop into any PHPue project.
- [PHPue Agent Skill for Claude Code and Codex](https://ai.phpue.co.uk/knowledge/agent-skill.md): Download the Agent Skill the PHPue author uses (SKILL.md, in-depth references, a starter app and compile/lint scripts) and install it for Claude Code, Codex or the Claude apps.
- [Quick start: your first PHPue app](https://ai.phpue.co.uk/knowledge/quickstart.md): Get the two core files, write App.pvue and a view, run it with php -S, build .dist and deploy.

## Core reference

- [.pvue files: the four blocks](https://ai.phpue.co.uk/knowledge/pvue-files.md): The script (PHP), header (head tags), template (HTML) and cscript (browser JS) blocks, and how the compiler finds them.
- [Templates: {{ }}, p-if, p-for and forms](https://ai.phpue.co.uk/knowledge/templates.md): Escaped output, conditional and repeated elements, raw PHP in templates, forms without p-model, and showing PHPue code as text.
- [Components and inherited scope](https://ai.phpue.co.uk/knowledge/components.md): @require, <Component/> tags, why components need no props (they inherit the parent scope), loops and the rules for component code.
- [Views, routing and 404 pages](https://ai.phpue.co.uk/knowledge/routing.md): File-name routing from views/*.pvue, #require, query parameters instead of nested paths, navigation helpers and custom 404 pages.
- [@AJAX: server functions for the browser](https://ai.phpue.co.uk/knowledge/ajax.md): Declaring @AJAX('POST'|'GET') handlers, calling them with fetch, method enforcement, responses, uploads and security.
- [backend/, scope, sessions and language](https://ai.phpue.co.uk/knowledge/backend.md): Auto-loaded backend classes and singletons, variable scope between App, views and AJAX, PHPUE_SESSION lazy sessions, phpue_set_lang and file paths.
- [cscript, AlpineJS, x-ssr and HTMX](https://ai.phpue.co.uk/knowledge/client-js.md): Passing PHP data to JavaScript, adding AlpineJS, the x-ssr directive for server-rendered lists, and HTMX-style navigation.

## Ship it

- [Build, deploy, security and caching](https://ai.phpue.co.uk/knowledge/build-deploy.md): Serving modes, php index.php build, the .dist layout, deployment options, Apache/nginx config, dev-tool safety and cacheable pages.
- [Official extensions](https://ai.phpue.co.uk/knowledge/extensions.md): MetaControl for per-page SEO, Matrix CMS for flat-file content, x-ssr for Alpine, and the multilingual pattern.

## Examples

- [Copy-ready recipes](https://ai.phpue.co.uk/knowledge/recipes.md): Complete, compiler-checked .pvue examples: forms, AJAX counter, lists, components in loops, database pages, dynamic meta.
- [PHPue FAQ](https://ai.phpue.co.uk/knowledge/faq.md): Short, direct answers to the questions people ask about PHPue most often.

## Avoid mistakes

- [Common mistakes and verified fixes](https://ai.phpue.co.uk/knowledge/gotchas.md): Input-to-output table of the mistakes that silently break PHPue pages, with the fix for each.
- [Upgrading from 0.0.2 to 0.0.3](https://ai.phpue.co.uk/knowledge/upgrade.md): What 0.0.3 changed, how to upgrade, and the 0.0.2-only rules to apply when you maintain an older project.
- [Coming from React, Next.js, Vue, Blade or plain PHP](https://ai.phpue.co.uk/knowledge/migration.md): Concept-by-concept mapping from other frameworks to PHPue, and when PHPue is (or is not) the right tool.

## Agent Skill

- [PHPue skill for Claude Code and Codex (zip)](https://ai.phpue.co.uk/skills/phpue.zip): the skill the PHPue author uses: SKILL.md, in-depth references/, a starter app in templates/, and compile/lint scripts. Unzip into ~/.claude/skills or ~/.codex/skills.
- [Skill entry point](https://ai.phpue.co.uk/skills/phpue/SKILL.md): the SKILL.md on its own.

## Optional

- [Full knowledge in one file](https://ai.phpue.co.uk/llms-full.txt): every topic above, concatenated.
- [Official documentation](https://phpue.co.uk/docs): the human docs on phpue.co.uk.
- [PHPue on GitHub](https://github.com/PHPue/PHPue): index.php and conversion.php, the two framework files.
- [Official extensions](https://github.com/PHPue/PHPue-Extensions): MetaControl, Matrix CMS, x-ssr.
- [This knowledge base on GitHub](https://github.com/PHPue/PHPue-AI): source of this site; content lives in www/backend/knowledge/content/.