nowo-tech/ux-link-bundle

Symfony bundle to generate contact, share, map, and download links with safe URLs, Twig helpers, and extensible providers.

v1.0.7 2026-07-29 17:45 UTC

Requires

• php: >=8.2 <8.6
• symfony/config: ^7.0 || ^8.0
• symfony/dependency-injection: ^7.0 || ^8.0
• symfony/framework-bundle: ^7.0 || ^8.0
• symfony/http-kernel: ^7.0 || ^8.0
• symfony/translation: ^7.0 || ^8.0
• symfony/twig-bundle: ^7.0 || ^8.0
• symfony/ux-twig-component: ^2.20 || ^3.0
• symfony/yaml: ^7.0 || ^8.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.0
• nowo-tech/phpstan-frankenphp: ^1.0
• phpstan/extension-installer: ^1.4
• phpstan/phpstan: ^2.0
• phpstan/phpstan-phpunit: ^2.0
• phpstan/phpstan-symfony: ^2.0
• phpunit/phpunit: ^10.0
• rector/rector: ^2.0
• symfony/browser-kit: ^7.0 || ^8.0
• symfony/phpunit-bridge: ^7.0 || ^8.0

Suggests

• symfony/flex: For automatic recipe installation (config and bundles.php)
• symfony/stimulus-bundle: Optional Stimulus controllers (Web Share API, clipboard) in future releases
• symfony/ux-icons: Optional icon rendering for link components

MIT

• Héctor Franco Aceituno
• Nowo.tech

• symfony
• php
• twig
• bundle
• maps
• links
• whatsapp
• share
• ux
• frankenphp
• twig-component

Published on Packagist.org on 2026-07-29 17:45 UTC

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.

Version information

Version	PHP	Symfony	Status
1.0.x	>= 8.2	7.0 – 8.1+	Supported

Install a specific release:

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

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' => '[phone]',
    'message' => 'Hello',
]);
echo $link->getUrl();

Quick example (Twig)

{{ ux_link_url('contact', 'whatsapp', { recipient: '[phone]', message: 'Hello' }) }}

Quick example (Twig Component)

<twig:UxLink family="contact" provider="whatsapp" recipient="[phone]" message="Hello" />

Demos

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

Documentation

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

Additional documentation

• 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.