Download the PHP package mohamedmohamedhekal/flagdeck without Composer
On this page you can find all versions of the php package mohamedmohamedhekal/flagdeck. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download mohamedmohamedhekal/flagdeck
More information about mohamedmohamedhekal/flagdeck
Files in mohamedmohamedhekal/flagdeck
Package flagdeck
Short Description Production-ready feature flags, percentage rollouts, and tenant targeting for Laravel
License MIT
Homepage https://github.com/mohamedhekal/flagdeck
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package flagdeck
FlagDeck
Production-minded feature flags for Laravel: boolean switches, percentage rollouts, and first-class user/tenant targeting—without a hosted feature-flag SaaS.
Replace the badge URLs with your GitHub org/user once the repository is published.
Problem
Shipping entitlements and gradual rollouts usually means either:
- hard-coded
ifchecks that rot across the codebase, or - a third-party flag service that is expensive and adds another operational dependency.
Laravel’s built-in options are intentionally minimal. Multi-tenant SaaS apps need allow/deny lists per tenant, sticky percentage buckets, cacheable evaluation, and an audit trail of who changed what.
Features
- Boolean flags with a master enable switch
- Percentage rollouts with sticky bucketing
- User and tenant include/exclude lists
- Environment-scoped flags
- Cache-backed definition reads with bust-on-write
FlagDeckfacade +feature:middleware + Blade@feature- Optional management HTTP API (disabled by default)
- Mutation audit log
- Artisan commands for list/set/cache clear
Requirements
- PHP 8.2+
- Laravel 11 or 12
Installation
Publish config (optional) and run migrations:
Quick start
Middleware
Blade
Artisan
Configuration
See config/flagdeck.php after publishing. Important knobs:
| Key | Meaning |
|---|---|
missing_flag |
inactive (default, fail closed) or active |
cache.* |
Store, TTL, prefix |
bucketing.salt |
Changing salt reshuffles percentage cohorts |
api.enabled |
Expose management routes (keep behind auth) |
context.* |
Callables to resolve user/tenant/anonymous ids |
Architecture overview
Definitions live in feature_flags. Evaluation is pure given a FlagDefinition + EvaluationContext. Reads go through a cached repository decorator; writes audit and invalidate cache.
Details: docs/evaluation.md
Management API
Disabled by default. When enabled:
| Method | Path | Purpose |
|---|---|---|
| GET | /flagdeck/flags |
List |
| POST | /flagdeck/flags |
Create |
| GET | /flagdeck/flags/{key} |
Show |
| PUT/PATCH | /flagdeck/flags/{key} |
Update |
| DELETE | /flagdeck/flags/{key} |
Delete |
| GET | /flagdeck/evaluate/{key} |
Debug evaluate (also gated) |
Configure middleware in flagdeck.api.middleware. Do not expose evaluate in production without auth.
Testing
Security
- Fail closed for missing flags when gating entitlements.
- Keep the management API authenticated and authorized.
- Treat bucket salt as sensitive configuration (rotation redistributes users).
- See SECURITY.md.
Contributing
See CONTRIBUTING.md.
Roadmap
See ROADMAP.md. Filament admin, schedules, and experiments are intentionally not claimed as complete in v0.1.
FAQ
How is this different from Laravel Pennant?
Pennant is a great lightweight toggle API. FlagDeck focuses on multi-tenant targeting, sticky rollouts, audit, optional HTTP management, and an evaluation model aimed at SaaS entitlements.
Can I use it without Redis?
Yes. Any Laravel cache store works; array/file/database are fine for smaller apps.
What happens if percentage is set but the user is anonymous?
Evaluation falls back through configured bucket sources. If none resolve, percentage flags evaluate inactive (fail closed).
License
MIT — see LICENSE.
Credits
Built and maintained by Mohamed Hekal.
All versions of flagdeck with dependencies
illuminate/support Version ^11.0|^12.0
illuminate/database Version ^11.0|^12.0
illuminate/http Version ^11.0|^12.0
illuminate/routing Version ^11.0|^12.0
illuminate/console Version ^11.0|^12.0
illuminate/cache Version ^11.0|^12.0
illuminate/events Version ^11.0|^12.0