# Devtools

The admin devtools module contains development-only interfaces for generating business modules, reviewing UI and form components in the sandbox, and managing the local application version.

Source: `apps/admin/src/devtools/`

The frontend module is registered through `apps/admin/src/devtools/config/module.ts`. Its routes, menu, and translations are exposed only when `IS_DEV_MODE` is enabled. All devtools frontend routes are protected routes.

## Documentation

| Area             | Purpose                                                                                 | Documentation                                    |
| ---------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------ |
| Module generator | Generates backend and admin frontend modules from a database table and UI configuration | [Module generator](./module-generator/Readme.md) |
| Sandbox          | Interactive examples and copyable source snippets for shared UI and form controls       | [Sandbox](./sandbox/Readme.md)                   |

The version manager is part of the same source module but is outside the scope of these guides.

## Frontend Routes

| Route                                | Page                           |
| ------------------------------------ | ------------------------------ |
| `/devtools/module-generator`         | Module generator               |
| `/devtools/module-generator/docs`    | Module generator documentation |
| `/devtools/sandbox/ui`               | Shared UI component sandbox    |
| `/devtools/sandbox/forms`            | Composed form-control sandbox  |
| `/devtools/module-generator/version` | Version manager                |

Devtools module is enabled only in dev mode!