Reframe hero as user problems and add quick-start + ecosystem pages

- Hero tagline + 6 feature cards rewritten from inventory-listing to problem-first framing
- New guide/quick-start.md: 5-step concrete onboarding (install, base classes, trim+helpers, behavior, next steps)
- New guide/ecosystem.md: map of Tools dependencies, frequently-paired plugins, and the wider author-plugin family
- Sidebar Getting Started group includes both new entries

Author: dereuromark

docs/.vitepress/config.ts

@@ -6,10 +6,12 @@ function unifiedSidebar() {
       text: 'Getting Started',
       items: [
         { text: 'Overview', link: '/guide/' },
+        { text: '5-min Quick Start', link: '/guide/quick-start' },
         { text: 'Installation', link: '/guide/install' },
         { text: 'Upgrade Guide', link: '/guide/upgrade' },
         { text: 'Shims', link: '/guide/shims' },
         { text: 'Tools Backend', link: '/guide/backend' },
+        { text: 'Plugin Ecosystem', link: '/guide/ecosystem' },
       ],
     },
     {

docs/guide/ecosystem.md

@@ -0,0 +1,34 @@
+# Plugin Ecosystem
+
+Tools sits at the center of a small family of CakePHP plugins by the same maintainer. Each one has a specific job — Tools pulls in the few it depends on, and the others are opt-in.
+
+## What Tools depends on (auto-installed)
+
+| Plugin | Why Tools needs it |
+| --- | --- |
+| [cakephp-shim](https://github.com/dereuromark/cakephp-shim) | 4.x → 5.x BC shims (validation, model property style, etc.). Letting you migrate apps gradually instead of rewriting. |
+
+## Frequently paired with Tools
+
+These are not dependencies, but they're commonly installed alongside Tools because they extend the same areas.
+
+| Plugin | What it adds | When to add it |
+| --- | --- | --- |
+| [cakephp-setup](https://github.com/dereuromark/cakephp-setup) | Bake theme + setup commands + a small admin sidebar layout. | When you want a head start on baking and an opinionated admin shell. |
+| [cakephp-ide-helper](https://github.com/dereuromark/cakephp-ide-helper) | PHPStorm meta files for CakePHP — autocomplete on association calls, `loadModel()`, etc. | When using PHPStorm. Always. |
+| [cakephp-icon](https://github.com/dereuromark/cakephp-icon) | Icon helper (Font Awesome / Bootstrap / custom collections). | The dedicated replacement for the deprecated [`Tools\View\Helper\IconHelper`](/helper/icon). |
+| [cakephp-tools-extra](https://gitlab.com/markscherer/cakephp-tools-extra) | Less-stable utilities that don't meet the Tools quality bar yet. | If you need bleeding-edge bits. |
+| [cakephp-setup-extra](https://gitlab.com/markscherer/cakephp-setup-extra) | Same role for Setup. | Same caveat. |
+
+## Other plugins from the same author
+
+Worth knowing about, even if Tools doesn't depend on them.
+
+- **[cakephp-queue](https://github.com/dereuromark/cakephp-queue)** — background jobs.
+- **[cakephp-tinyauth](https://github.com/dereuromark/cakephp-tinyauth)** — INI-based ACL.
+- **[cakephp-geo](https://github.com/dereuromark/cakephp-geo)** — Geocoder behavior, GoogleMapsV3 helper.
+- **[cakephp-fixture-factories](https://github.com/dereuromark/cakephp-fixture-factories)** — factory-pattern test fixtures.
+- **[cakephp-dto](https://github.com/dereuromark/cakephp-dto)** — generated DTO classes from XML.
+- **[cakephp-templating](https://github.com/dereuromark/cakephp-templating)** — extra template helpers and view utilities.
+
+Browse the full list at <https://github.com/dereuromark?tab=repositories&q=cakephp>.

docs/guide/quick-start.md

@@ -0,0 +1,86 @@
+# 5-min Quick Start
+
+Get the most common Tools features wired up in five minutes.
+
+## 1. Install
+
+```bash
+composer require dereuromark/cakephp-tools
+bin/cake plugin load Tools
+```
+
+## 2. Use the Tools base classes
+
+In every Table, extend the Tools `Table`:
+
+```php
+namespace App\Model\Table;
+
+use Tools\Model\Table\Table;
+
+class UsersTable extends Table {}
+```
+
+In every Entity, extend the Tools `Entity`:
+
+```php
+namespace App\Model\Entity;
+
+use Tools\Model\Entity\Entity;
+
+class User extends Entity {}
+```
+
+You now have access to the extra validation rules ([URL](/reference/url), email/phone formats, ranges), `tokens` integration, native [Enum](/model/enum) helpers — see [Table](/model/table) for the full list.
+
+## 3. Auto-trim POSTs and load the helpers
+
+In `AppController`:
+
+```php
+namespace App\Controller;
+
+use Tools\Controller\Controller;
+
+class AppController extends Controller {
+    public function initialize(): void {
+        parent::initialize();
+        $this->loadComponent('Tools.Common');  // auto-trim POST data so notEmpty validation works
+    }
+}
+```
+
+In `AppView`:
+
+```php
+public function initialize(): void {
+    parent::initialize();
+    $this->loadHelper('Tools.Common');
+    $this->loadHelper('Tools.Format');
+}
+```
+
+That's the minimum — `Common` covers misc rendering, `Format` covers numbers/dates/badges/status pills.
+
+## 4. Add a behavior to a Table
+
+Every behavior is a one-liner in `initialize()`:
+
+```php
+class ArticlesTable extends Table {
+    public function initialize(array $config): void {
+        parent::initialize($config);
+        $this->addBehavior('Tools.Slugged', ['field' => 'title']);
+    }
+}
+```
+
+Browse the [behaviors index](/behavior/) for the full list — each page has a minimal config example.
+
+## 5. Where to next
+
+- [Behaviors](/behavior/) — Slugged, Bitmasked, Passwordable, Jsonable, Reset, Toggle, AfterSave, String, Encryption, Typographic
+- [Helpers](/helper/) — Common, Format, Form, Html, Tree, Progress, Meter, Typography, Icon
+- [Components](/component/) — Common, Mobile, RefererRedirect
+- [Live Sandbox](https://sandbox.dereuromark.de/sandbox/tools-examples) — runnable examples for most features
+- [Plugin Ecosystem](/guide/ecosystem) — how Tools fits with Shim, Setup, IDE Helper, and friends

docs/index.md

@@ -4,14 +4,14 @@ layout: home
 hero:
   name: cakephp-tools
   text: The CakePHP Toolbox
-  tagline: Behaviors, helpers, components, model and entity utilities — the swiss-army-knife plugin for CakePHP applications.
+  tagline: Stop reinventing slugs, password flows, bitmasks, and the dozen helpers you copy into every CakePHP app.
   image:
     src: /logo.svg
     alt: cakephp-tools
   actions:
     - theme: brand
-      text: Get Started
-      link: /guide/
+      text: 5-min Quick Start
+      link: /guide/quick-start
     - theme: alt
       text: Live Sandbox
       link: https://sandbox.dereuromark.de/sandbox/tools-examples
@@ -21,21 +21,21 @@ hero:
 
 features:
   - icon: 🧱
-    title: Behaviors
-    description: Ten production-ready ORM behaviors — Bitmasked, Slugged, Passwordable, Jsonable, Reset, Toggle, AfterSave, String, Encryption, Typographic.
+    title: Behaviors you'd write yourself anyway
+    details: Slugs, bitmasks, password change with confirm, JSON columns, soft toggles — ten battle-tested ORM behaviors instead of a folder full of half-finished traits.
   - icon: 🎨
-    title: Helpers
-    description: View helpers for HTML, Form, Format, Tree, Progress, Meter, Typography, Icon, and a Common helper covering frequent app needs.
-  - icon: 🧩
-    title: Components
-    description: Common, Mobile, RefererRedirect — drop-in controller components for the boilerplate you would otherwise write yourself.
+    title: Your AppView, pre-loaded
+    details: Format, Html, Form, Tree, Progress and a Common helper covering the rendering you keep adding to every project. Load two helpers and stop writing element wrappers.
   - icon: 🗃️
-    title: Model & Entity
-    description: Improved Table base class with extra validation rules, native Enum and StaticEnum traits, and Tokens table for one-time link / token flows.
+    title: A Table base that knows the things you forgot
+    details: Validation rules core CakePHP doesn't ship (URL, email, phone, ranges), plus Tokens for one-time login links and native Enum integration.
+  - icon: 🧩
+    title: Controller boilerplate, gone
+    details: Auto-trim POST data so empty validation behaves. Mobile detection. Safe redirect-to-referer with allow-listing. Three components instead of three new files in src/Controller/Component.
   - icon: 🌍
-    title: I18n & Routing
-    description: Locale detection and switching, improved DateTime / Date handling, plus URL generation utilities.
+    title: i18n + URL helpers without the dance
+    details: Detect and switch locale with one component call. Improved DateTime/Date handling. URL generation utilities for the cases the core helper doesn't cover.
   - icon: 🛠️
     title: Plus the rest
-    description: ExceptionTrap for cleaner error handling, FileLog for one-line custom logging, login-link auth flow, Datalist widget, Inflect command, and more.
+    details: ExceptionTrap for cleaner errors, FileLog for one-line custom logging, login-link auth flow, Datalist widget, Inflect command. The whole [plugin ecosystem](/guide/ecosystem) connects them.
 ---