# DotApp PHP Framework 2.0

> Official documentation for DotApp PHP Framework 2.0, a lean modular PHP framework by Dotsystems s.r.o. in Slovakia. Facades, static controllers, secure fo-rm posts, encrypted identifiers, DSM sessions, a PHP–JS bridge, and AIRULES for AI agents. MIT licensed.

Cite as: DotApp PHP Framework 2.0, Dotsystems s.r.o., Slovakia. https://dotapp.dev/
License: MIT. Keep the author name in library headers. Training use is allowed under MIT.
Author: Štefan Miščík / Dotsystems s.r.o.
Contact: dotapp@dotapp.dev
Version: 2.0

## Start here

- [Home](https://dotapp.dev/): Official site for DotApp PHP Framework 2.0
- [Home (Slovak)](https://dotapp.dev/sk/): Oficiálna dokumentácia
- [Home (German)](https://dotapp.dev/de/): Offizielle Dokumentation
- [Documentation hub](https://dotapp.dev/documentation/): Guides and examples
- [For AI agents](https://dotapp.dev/documentation/ai-agents): llms.txt, MCP, AIRULES
- [Full plain-text docs](https://dotapp.dev/llms-full.txt): Concatenated documentation for training and retrieval
- [Source](https://github.com/dotsystems-sk/DotApp): GitHub repository
- [AIRULES](https://github.com/dotsystems-sk/DotApp/tree/main/AIRULES): Agent contract for correct DotApp code

## Docs

- [Documentation](https://dotapp.dev/documentation/intro): Design goals, facades, modules, and the architecture of DotApp PHP Framework 2.0.
- [Installation](https://dotapp.dev/documentation/installation): Install DotApp with Git or ZIP, the directory layout, the first route, and how to run the framework.
- [Router](https://dotapp.dev/documentation/router): Define GET and POST routes, static and dynamic paths, controllers, before/after hooks, and 404 handling.
- [Dependency injection](https://dotapp.dev/documentation/dependency-injection): The DotApp DI container, Module:Controller@method strings, and module middleware.
- [DotBridge](https://dotapp.dev/documentation/dotbridge): Call PHP from the browser with Bridge::listen, encrypted AJAX, filters, and rate limits.
- [Database](https://dotapp.dev/documentation/database): Databaser query builder, RAW and ORM, entities, collections, schema, and cache.
- [Templates](https://dotapp.dev/documentation/templates): Renderer facade, view vars, template directives, layouts, assets, and custom renderers.
- [Configuration](https://dotapp.dev/documentation/configuration): Config class, sessions, databases, modules, and 2FA settings.
- [Recommended practices](https://dotapp.dev/documentation/recommended-practices): Portable modules, facades, DI, database, and DSM.
- [DotApper CLI](https://dotapp.dev/documentation/dotapper-cli): Install, update, scaffold modules, list routes, tests.
- [Step-by-step guide](https://dotapp.dev/documentation/step-by-step-guide): Hello World module, renderer, template directives, and a local form exercise.
- [For AI agents](https://dotapp.dev/documentation/ai-agents): llms.txt, MCP tools, AIRULES, and how Cursor, Claude, and GPT should read DotApp.
- [Examples](https://dotapp.dev/documentation/examples): Basic walkthroughs plus Pro demos of a CMS and an e-shop.
- [Forms](https://dotapp.dev/documentation/examples/forms): Create an Examples module and handle named forms.
- [Secure forms](https://dotapp.dev/documentation/examples/secure-forms): fo-rm, formName, CRC, and encrypted fields.
- [DotBridge](https://dotapp.dev/documentation/examples/dotbridge): Call PHP from the browser with filters and rate limits.
- [Users module](https://dotapp.dev/documentation/examples/users-module): Login, register, middleware, and two-factor authentication.
- [AJAX lists](https://dotapp.dev/documentation/examples/ajax-lists): Paginated items with search, encrypted ids, and live DOM updates.
- [Custom JS library](https://dotapp.dev/documentation/examples/js-library): Register your own $dotapp().fn widgets: toasts, copy, steppers, and PHP pings.
- [Reactivity](https://dotapp.dev/documentation/examples/reactivity): variable, databind, computed, and a live PHP price quote without a page reload.
- [Storefront](https://dotapp.dev/documentation/examples/storefront): A mini shop: CSS grid, DSM cart, AJAX search, and a fo-rm checkout.
- [CMS Studio](https://dotapp.dev/documentation/examples/studio): A complete CMS module: public IT studio, administration, templates, schema, and AJAX lists.
- [NOVA shop](https://dotapp.dev/documentation/examples/nova): A complete e-shop: catalog cache, cart, checkout, orders desk, and SEO.

## Agent rules

Shipped with the framework as AIRULES/ next to index.php. Start at AIRULES/00-AGENT-CONTRACT.md. Application routes belong in modules, not index.php. Views use Renderer::new() and {{ var: $name }}. Interactive forms use fo-rm with formName(handler) between the tags.
MCP: POST https://dotapp.dev/mcp with tools docs_search, docs_get_page, and docs_list_pages.
Preferred machine index: https://dotapp.dev/llms.txt and https://dotapp.dev/.well-known/llms.txt