README

⭐ Found this useful? Install from Packagist and give the repo a star on GitHub. It helps us maintain and improve the project.

Generate safe, extensible contact, share, map, and download links for Symfony applications.

This bundle is FrankenPHP worker mode friendly (including reset_kernel: false). See the worker audit.

Installation

composer require nowo-tech/ux-link-bundle

Register the bundle (Symfony Flex does this automatically):

// config/bundles.php
Nowo\UxLinkBundle\NowoUxLinkBundle::class => ['all' => true],

Quick example (PHP)

use Nowo\UxLinkBundle\Contract\LinkFactoryInterface;

$link = $linkFactory->create('contact', 'whatsapp', [
    'recipient' => '+34600111222',
    'message' => 'Hello',
]);
echo $link->getUrl();

Quick example (Twig)

{{ ux_link_url('contact', 'whatsapp', { recipient: '+34600111222', message: 'Hello' }) }}

Quick example (Twig Component)

<twig:UxLink family="contact" provider="whatsapp" recipient="+34600111222" message="Hello" />

Version information

Install a specific release:

composer require nowo-tech/ux-link-bundle:^1.1

Demos

make -C demo up-symfony8   # http://localhost:8048

The screenshot at the top of this README comes from this demo; refresh it with make -C demo/symfony8 demo-screenshots (make -C demo/symfony8 test-e2e runs the Playwright happy path).

Documentation

• Installation
• Configuration
• Usage
• Contributing
• Code of Conduct
• Changelog
• Upgrading
• Release
• Security
• Engram
• Spec-driven development
• GitHub Spec Kit

Additional documentation

• GitHub Actions CI requirements
• PSR evaluation (REQ-CS-007)
• FrankenPHP worker audit
• Demo with FrankenPHP (includes worker mode)

Tests and coverage

• Tests: PHPUnit (unit + integration)
• PHP: 100%
• TS/JS: N/A
• Python: N/A

make test
make test-coverage

License

MIT — see LICENSE.