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.1 2026-07-08 15:58 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
• 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
• twig
• bundle
• maps
• links
• whatsapp
• share
• ux
• twig-component

Published on Packagist.org on 2026-07-08 15:58 UTC

README

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

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" />

Documentation

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

Additional documentation

• Demo with FrankenPHP (includes worker mode)

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

Demos

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

Tests and coverage

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

make test
make test-coverage

Found this useful?

Give it a star on GitHub.

License

MIT — see LICENSE.