PHPackages                             nowo-tech/yopass-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Security](/categories/security)
4. /
5. nowo-tech/yopass-bundle

ActiveSymfony-bundle[Security](/categories/security)

nowo-tech/yopass-bundle
=======================

Symfony bundle for Yopass-style E2E encrypted secret sharing with configurable routes, table prefix, and access control

v1.4.1(2w ago)017MITPHPPHP &gt;=8.2 &lt;8.6CI passing

Since Jul 4Pushed 1mo agoCompare

[ Source](https://github.com/nowo-tech/YopassBundle)[ Packagist](https://packagist.org/packages/nowo-tech/yopass-bundle)[ Docs](https://packagist.org/packages/nowo-tech/yopass-bundle)[ GitHub Sponsors](https://github.com/HecFranco)[ RSS](/packages/nowo-tech-yopass-bundle/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (6)Dependencies (79)Versions (19)Used By (0)

Yopass Bundle
=============

[](#yopass-bundle)

[![CI](https://github.com/nowo-tech/YopassBundle/actions/workflows/ci.yml/badge.svg)](https://github.com/nowo-tech/YopassBundle/actions/workflows/ci.yml) [![Packagist Version](https://camo.githubusercontent.com/878812e213ab5a46d2b5817c9c59738d56a57113833acfc66bab9ec625053f16/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e6f776f2d746563682f796f706173732d62756e646c652e7376673f7374796c653d666c6174)](https://packagist.org/packages/nowo-tech/yopass-bundle) [![Packagist Downloads](https://camo.githubusercontent.com/169a685bdfd83ef60646611942bb4002f78d508b1d07161e1ac9693de87afadd/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e6f776f2d746563682f796f706173732d62756e646c652e737667)](https://packagist.org/packages/nowo-tech/yopass-bundle) [![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](LICENSE) [![PHP](https://camo.githubusercontent.com/3f99b197569aa2dcfbefff17ecc68d74098e7f929d8b52dc40f3a898f740eae1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322532422d3737374242343f6c6f676f3d706870)](https://php.net) [![Symfony](https://camo.githubusercontent.com/1a126614274d9b3881d3583579aa40bfbc1b85ae18daf0dc9390bf413426abfb/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53796d666f6e792d372e34253242253230253743253230382e30253230253743253230382e312532422d3030303030303f6c6f676f3d73796d666f6e79)](https://symfony.com) [![GitHub stars](https://camo.githubusercontent.com/461cf16f9538a469017808e3a5109e4fbdd2e3c565998bc8168b4f5d8c757943/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6e6f776f2d746563682f596f7061737342756e646c652e7376673f7374796c653d736f6369616c266c6162656c3d53746172)](https://github.com/nowo-tech/YopassBundle) [![Coverage](https://camo.githubusercontent.com/162999695c2201dca91526ab1f678bef5da235234569438647146863b5d4e439/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f7665726167652d3130302532352532305048502532302537432532307e373625323525323054532d627269676874677265656e)](#tests-and-coverage)

> ⭐ **Found this useful?** Give it a **star** on [GitHub](https://github.com/nowo-tech/YopassBundle) so more developers can find it.

Symfony bundle for **Yopass-style E2E encrypted secret sharing**: client-side libsodium encryption, expiration, read limits, and public reveal pages.

**FrankenPHP worker mode:** Supported — stateless controllers and services; tested with the Symfony 8 demo using FrankenPHP (see [Demo with FrankenPHP](docs/DEMO-FRANKENPHP.md)).

Features
--------

[](#features)

- Browser-side encryption (`libsodium` secretbox); server stores ciphertext only
- Text and file payloads (max 512 KB files; file tab requires `file_handler` service)
- Configurable expiration options, max-read limits, list pagination, and retention purge
- Auto-generated decryption key or custom password mode
- One-click links via `?decrypt_key=` query parameter; short links with manual key entry
- Authenticated manage UI + anonymous public reveal/consume routes
- Configurable routes, table prefix, templates, and pluggable access control
- **Share events** — customize list queries and per-share access (teams, grants, roles) without built-in ACL
- **Public rate limiting** — per-IP limits on anonymous `/share/*` routes (requires `cache.app`)

Installation
------------

[](#installation)

```
composer require nowo-tech/yopass-bundle
```

See [Installation](docs/INSTALLATION.md) for Flex recipe, Doctrine schema, routes, and security firewall setup.

Configuration
-------------

[](#configuration)

```
# config/packages/nowo_yopass.yaml
nowo_yopass:
    user_class: App\Entity\User
    table_prefix: yopass_
    security:
        access_checker: App\Security\CustomYopassAccessChecker  # optional
```

Full reference: [Configuration](docs/CONFIGURATION.md).

Usage
-----

[](#usage)

- Manage UI: `/tools/yopass` (configurable)
- Public reveal: `/share/{id}` or `/share/{id}?decrypt_key=…` (configurable)
- Override Twig: `templates/bundles/NowoYopassBundle/`

See [Usage](docs/USAGE.md) and [Access control events](docs/examples/AccessControl.md).

Demo
----

[](#demo)

```
make -C demo up-symfony8
# Demo started at: http://localhost:8022  →  Yopass CRUD at /tools/yopass (auto-login)
```

Documentation
-------------

[](#documentation)

- [Installation](docs/INSTALLATION.md)
- [Configuration](docs/CONFIGURATION.md)
- [Usage](docs/USAGE.md)
- [Contributing](docs/CONTRIBUTING.md)
- [Changelog](docs/CHANGELOG.md)
- [Upgrading](docs/UPGRADING.md)
- [Release process](docs/RELEASE.md)
- [Security](docs/SECURITY.md)
- [Engram](docs/ENGRAM.md)
- [Spec-driven development](docs/SPEC-DRIVEN-DEVELOPMENT.md)
- [GitHub Spec Kit](docs/SPEC-KIT.md)

### Additional documentation

[](#additional-documentation)

- [Share list and access events](docs/examples/AccessControl.md)
- [Demo with FrankenPHP](docs/DEMO-FRANKENPHP.md)
- [Local file storage (demo default)](docs/examples/LocalStorage.md)
- [AWS S3 file shares example (local, gitignored)](docs/examples/S3.md)

Tests and Coverage
------------------

[](#tests-and-coverage)

```
make test              # PHPUnit
make test-coverage     # PHP coverage + percentage script
make test-ts           # Vitest (crypto)
make release-check     # Full pre-release chain
```

LanguageCoveragePHP**100%** (Lines) — `make test-coverage-100`TypeScript**~76%** (Lines) — `make test-ts` (password-mode paths require browser sodium runtime)License
-------

[](#license)

MIT — see [LICENSE](LICENSE).

###  Health Score

45

—

FairBetter than 91% of packages

Maintenance94

Actively maintained with recent releases

Popularity8

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 66.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~2 days

Total

17

Last Release

14d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e7947bfc3f2ce9574a18a2c60f3d95b5d1b0740e65dc929332c92f1df21f75ab?d=identicon)[HecFranco](/maintainers/HecFranco)

---

Top Contributors

[![HecFranco](https://avatars.githubusercontent.com/u/24323276?v=4)](https://github.com/HecFranco "HecFranco (14 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (5 commits)")[![actions-user](https://avatars.githubusercontent.com/u/65916846?v=4)](https://github.com/actions-user "actions-user (2 commits)")

---

Tags

phpsymfonysecurityencryptionfrankenphpSymfony Bundlee2esecret-sharingyopass

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/nowo-tech-yopass-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/nowo-tech-yopass-bundle/health.svg)](https://phpackages.com/packages/nowo-tech-yopass-bundle)
```

###  Alternatives

[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k18.3M430](/packages/easycorp-easyadmin-bundle)[2lenet/crudit-bundle

The easy like Crud'it Bundle.

1617.3k16](/packages/2lenet-crudit-bundle)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.5k6.0M779](/packages/sylius-sylius)[contao/core-bundle

Contao Open Source CMS

1301.7M3.1k](/packages/contao-core-bundle)[pimcore/pimcore

Content &amp; Product Management Framework (CMS/PIM/E-Commerce)

3.8k3.9M536](/packages/pimcore-pimcore)[open-dxp/opendxp

Content &amp; Product Management Framework (CMS/PIM)

9626.1k69](/packages/open-dxp-opendxp)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
