Skip to content

Align the Thelia 3 skills on 3.0.0-beta3 - #5

Merged
anoziere merged 3 commits into
mainfrom
docs/beta3-alignment
Aug 14, 2026
Merged

Align the Thelia 3 skills on 3.0.0-beta3#5
anoziere merged 3 commits into
mainfrom
docs/beta3-alignment

Conversation

@anoziere

Copy link
Copy Markdown
Member

Updates the plugin skills to match Thelia 3 as released in 3.0.0-beta3, and corrects the statements that the release made false.

Corrected

  • Flexy assets: Webpack Encore, package.json and npm run build are gone. The theme runs on AssetMapper (importmap.php) and a standalone Tailwind v4 CLI binary.
  • Flexy structure: src/UiComponents/ became components/ (PSR-4 FlexyBundle\Components\). The @components, @UiComponents, @assets and @formTwig Twig namespaces became @Flexy and @FlexyForm. The TwigComponent name prefix is empty, so component attributes are written bare — every #[AsLiveComponent(name: 'Flexy:...')] example was wrong.
  • thelia/front-module: no longer a dependency. The theme owns the catch-all /{_view} route through FlexyBundle\Controller\ViewController, which delegates to DefaultController::noAction.
  • Form themes: neither theme registers globally any more. The back-office rationale ("the Flexy theme wins the global lookup") no longer held; a form with no form_theme tag now falls back to bare Symfony markup.
  • Versions: 3.0.0-beta1 replaced throughout, including THELIA_VERSION. Records that the skeleton and each template move on their own version track.
  • PHP: 8.3 and 8.4, not 8.3 alone.
  • Dropped the "Encore -> Vite" evolution note, now moot.

Added

  • A missing GitHub token fails an install on an unrelated message. Flex silently falls back to auto-generated recipes, never writes Thelia's config/packages/*.yaml, and the install dies far downstream on You must either configure a "public_key" or a "secret_key".
  • LiveComponents 404 without ignore_thelia_view: true on /_components. The recipe sets it, but Flex does not rewrite an existing routing file, so upgraded projects keep the old one.
  • Front assets are automatic, back-office assets are not. bin/install runs importmap:install then tailwind:build; the back-office dist/ is gitignored and still needs npm install && npm run build.
  • config/views.yaml and InternalViewsDeclaration: how a theme declares root templates that are not pages.
  • CustomerPersonalDataProviderInterface for adding a section to the customer data export, and the rate-limited CustomerCodeManager::requestCode().
  • provide() / inject() on PHP 8.3, supplied by the theme's ComponentContextExtension because ux-twig-component resolves to 2.x there.
  • The virtual product download route and its event.

Neutrality check passes. Plugin bumped 0.3.0 -> 0.4.0.

@anoziere
anoziere merged commit 09e8bb7 into main Aug 14, 2026
2 checks passed
@anoziere
anoziere deleted the docs/beta3-alignment branch August 14, 2026 10:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant