# TAW — Build with WordPress

## Documentation

- [Introduction](https://taw.mlizardo.com/introduction.md): TAW is a modern WordPress theme framework built around PHP blocks, a config-driven metabox engine, and a Vite/Tailwind asset pipeline — no Gutenberg, no ACF, no bloat.
- [Quickstart](https://taw.mlizardo.com/quickstart.md): Install TAW Theme, start the Vite dev server, scaffold your first MetaBlock, and render it on a page — in under 10 minutes.
- [Theme boot and performance](https://taw.mlizardo.com/taw-theme.md): Initialize the TAW Core theme bootstrap, configure performance optimizations, and discover helper classes you will use in your templates.
- [TAW Core Tools](https://taw.mlizardo.com/taw-core.md): Overview of the developer tools TAW Core exposes for the TAW Theme, including CLI commands, runtime APIs, forms, mail, and debugging helpers.
- [Blocks and block registry](https://taw.mlizardo.com/taw-core-blocks.md): How BlockLoader discovers blocks automatically, how BlockRegistry queues and renders them, and the difference between MetaBlocks and UI Blocks.
- [Assets and Vite integration](https://taw.mlizardo.com/taw-core-assets-vite.md): How TAW Core uses Vite for script and style loading, how critical CSS is inlined, and how to reference hashed assets anywhere in your templates.
- [Metabox and editor tooling](https://taw.mlizardo.com/taw-core-metabox.md): Declare structured metaboxes in PHP, use the full field-type library, wire conditional logic, and retrieve saved values in your templates.

## Help Center

- [Help Center](https://taw.mlizardo.com/help-center.md): Answers to common questions, troubleshooting guides, and how-tos for building with TAW Theme and taw/core.
- [Getting started FAQ](https://taw.mlizardo.com/help-center/faq/getting-started.md): Answers to the most common questions when setting up TAW Theme for the first time.
- [Common errors and fixes](https://taw.mlizardo.com/help-center/troubleshooting/install-error.md): Diagnose and fix the most common issues when installing and running TAW Theme.
- [Setting up a new TAW project](https://taw.mlizardo.com/help-center/guides/setup-project.md): A complete walkthrough for going from zero to a running TAW Theme with your first block, from Composer install through to production build.
- [Connect your AI agent to these docs](https://taw.mlizardo.com/help-center/guides/ai-agent-setup.md): Give Claude Code, Cursor, Windsurf, or any MCP-compatible AI assistant live access to the TAW documentation so it can look up components, field types, and API references without leaving your editor.

## Tutorials

- [Build your first MetaBlock](https://taw.mlizardo.com/tutorials/first-metablock.md): Go from zero to a fully working page section: scaffold a MetaBlock with the CLI, register metabox fields, return template variables, and render it on a page.
- [Contact form with MJML email notifications](https://taw.mlizardo.com/tutorials/contact-form-mjml.md): Build a contact form using TAW's Forms API, write branded email templates in MJML, and deliver notifications to the site admin and the submitter automatically.

## Changelog

- [Changelog](https://taw.mlizardo.com/changelog.md): Release history for TAW Theme and the taw/core framework package.