wappler
4f0ef67f4d
Catalog of the ~200+ typed Site Settings shipped by t3bootstrap/template (Configuration/Sets/Template/settings.definitions.yaml) and t3bootstrap/core (Configuration/Sets/T3BCore/settings.definitions.yaml). Covers: - Header (logo, layout 0-5, sticky, searchbox) - Navigation: main/sub/mobile/language/footer/meta/breadcrumb/aria with menuType options - Design colors (primary/secondary, dark mode via data or media-query, contrast mode) - Design fonts (font families + h1-h6 + display1-6 sizes) - Body / footer (background-media slide, CTA bar, footer.contentPageId) - Meta / favicons / web manifest / theme color / referrer - Search + indexed_search wiring - Bootstrap tokens (breakpoints, breakpointsMax, containerWidths, gridColumns) - Spacing scale (7-step rem system → CSS custom properties + utility classes) - Icons (rendering svg/iconfont, defaultSize, defaultColor) - Images (preferredImageFormat webp/avif, fullwidth handling) - Buttons (registered classes) - Privacy policies - Custom setting types: ctabaritemlist, ctabuttonlist, calltoactionlist - Add-ons: t3bootstrap-blog.listDesign, filecollection_gallery Plus 17-recipe cookbook (brand colors, header layout, off-canvas mobile menu, megamenu, language switcher, dark mode, custom breakpoints, custom spacing, WebP images, indexed search, PWA manifest, felogin, social CTA bar, CTA buttons, customer defaults) and anti-patterns (editing vendor definitions, mixing constants and settings, structural per-language overrides). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
77 lines
4.3 KiB
Markdown
77 lines
4.3 KiB
Markdown
# T3Bootstrap Skills
|
|
|
|
Agent Skills for working with the **T3Bootstrap** stack on TYPO3 v14 — the WapplerSystems
|
|
ecosystem of `t3bootstrap/*` and `wapplersystems/*` extensions that delivers a Bootstrap 5
|
|
based site template, content elements, and feature packages.
|
|
|
|
These skills teach an AI coding agent **what comes from the stack out of the box** and
|
|
**how to extend it minimally** so that a customer project stays close to the upstream
|
|
packages and remains upgrade-friendly.
|
|
|
|
> **Companion plugin:** [`wapplersystems/typo3-skills`](https://github.com/Starraider/typo3-skills)
|
|
> covers generic TYPO3 v14 topics (Fluid patterns, Extbase, Content Blocks, CSP, Playwright,
|
|
> …). The skills here are intentionally **T3Bootstrap-specific** and reference real
|
|
> `t3bootstrap/*` package paths.
|
|
|
|
## Repository Layout
|
|
|
|
```
|
|
.agents/skills/<skill-name>/
|
|
├── SKILL.md # Skill definition (description + workflow)
|
|
└── agents/openai.yaml # Standardized agent interface
|
|
```
|
|
|
|
## Available Skills
|
|
|
|
| Skill | Purpose |
|
|
| --- | --- |
|
|
| [t3bootstrap-site-package](./.agents/skills/t3bootstrap-site-package/SKILL.md) | Set up a TYPO3 v14 project on the T3Bootstrap stack: `composer.json` repositories, the right `t3bootstrap/*` + `wapplersystems/*` packages, site sets in `config/sites/<site>/config.yaml`, when (and when not) to add a local site package, language configuration, route enhancers. |
|
|
| [t3bootstrap-site-settings](./.agents/skills/t3bootstrap-site-settings/SKILL.md) | Catalog of the ~200+ typed Site Settings exposed by `t3bootstrap/template` and `t3bootstrap/core` — header, navigation (main/sub/mobile/language/footer/meta/breadcrumb), design colors and fonts, dark/contrast mode, body/footer, meta/favicons, search, breakpoints, container widths, spacing, icons, buttons, privacy, plus the custom `ctabaritemlist` / `calltoactionlist` types for social-link editing. |
|
|
| [t3bootstrap-overrides](./.agents/skills/t3bootstrap-overrides/SKILL.md) | Minimal-invasive customization: Fluid template overrides via `templateRootPaths.10` / `partialRootPaths.10` / `layoutRootPaths.10`, SCSS variable overrides with `!default`, TypoScript constants, when to override what — without forking `t3bootstrap/template`. |
|
|
| [t3bootstrap-content-elements](./.agents/skills/t3bootstrap-content-elements/SKILL.md) | Catalog of the 23 `t3bs_*` content elements from `t3bootstrap/container-bs5-templates`, decision matrix for content migration (static HTML, WordPress, Joomla, older TYPO3, Flux-bs5), and the `t3bsContainerBs5MigrateFluxBs5` upgrade wizard. |
|
|
|
|
## How Skills Are Invoked
|
|
|
|
Skills are auto-discovered by Claude Code from the `skills:` entry in `.claude-plugin/plugin.json`.
|
|
Each skill's `SKILL.md` declares a description that triggers automatic invocation when the user's
|
|
request matches.
|
|
|
|
Explicit invocation: mention the skill by name in a prompt
|
|
(e.g. *"use the `t3bootstrap-content-elements` skill to map this WordPress accordion"*).
|
|
|
|
## Stack Versions This Plugin Targets
|
|
|
|
- TYPO3 **v14** (Composer mode)
|
|
- `t3bootstrap/template` `dev-release/v14`
|
|
- `t3bootstrap/core` `dev-release/v14`
|
|
- `t3bootstrap/container-bs5-templates` `dev-release/v14`
|
|
- Bootstrap **5**
|
|
- PHP **8.3+** (PHP 8.5 on the reference project)
|
|
- DDEV-based local dev
|
|
|
|
Skills assume TYPO3 v14. If a workflow differs on v13, the skill says so explicitly.
|
|
|
|
## Relation to the T3Bootstrap Page Builder
|
|
|
|
The reference project (`t3bootstrap14`) hosts a planned **Page Builder** inside
|
|
`t3bootstrap/core`. The skills here describe the **current** template-and-content-element
|
|
workflow. They will be revised as the builder lands and changes which configuration lives
|
|
where (Site Settings YAML vs. TypoScript constants).
|
|
|
|
## Contributing
|
|
|
|
PRs welcome at `git.wappler.systems:WapplerSystems/t3bootstrap-skills`.
|
|
|
|
Conventions:
|
|
|
|
- **Real package paths.** Skills reference real `t3bootstrap/*` / `wapplersystems/*` paths
|
|
rather than abstract placeholders — that *is* the topic. Customer site packages keep the
|
|
`my-site-package` / `Vendor\MySitePackage\` placeholders used in `typo3-skills`.
|
|
- **English content.** Frontmatter `description` and SKILL.md body in English. German
|
|
inline labels (e.g. backend field labels) are quoted verbatim from the upstream packages.
|
|
- **One SKILL.md per topic, deep but scannable.** Tables, file paths, code blocks. Avoid prose.
|
|
|
|
## License
|
|
|
|
[MIT](./LICENCE).
|