Binary Flags Laravel Package

Product Decisions This Supports

• Feature Development: Enables efficient storage and retrieval of boolean attributes (e.g., user permissions, feature toggles, or product configurations) as bitwise flags, reducing database bloat and improving query performance.
• Roadmap Alignment: Ideal for projects requiring scalable, low-latency flag management (e.g., SaaS platforms with tiered permissions or A/B testing systems).
• Build vs. Buy: Avoids reinventing bitwise logic; leverages a battle-tested, MIT-licensed solution with minimal maintenance overhead.
• Use Cases:
  • User role/permission systems (e.g., is_admin | is_premium | can_edit).
  • Feature flags with dynamic toggling (e.g., enable_dark_mode | beta_testing).
  • Product catalog filters (e.g., in_stock | discounted | new_arrival).
  • Analytics event tracking (e.g., viewed | clicked | converted).

When to Consider This Package

• Adopt When:

  • You need >10 boolean flags per record (e.g., user roles, product attributes) to justify bitwise optimization.
  • Your database schema uses UNSIGNED BIGINT (or equivalent) for numeric storage.
  • You’re using Laravel/Eloquent and want seamless integration via traits.
  • Your team prioritizes readability (e.g., user->hasFlag(UserFlags::IS_ADMIN)) over raw SQL bitwise ops.
  • You anticipate future-proofing (e.g., 64-bit flags for 100+ attributes).

• Look Elsewhere If:

  • You require >64 flags (use a separate flags table or JSON column instead).
  • Your system lacks UNSIGNED BIGINT support (e.g., SQLite, legacy MySQL).
  • Flags are sparse (e.g., <5 flags per record; simple boolean columns suffice).
  • You need audit trails or temporal tracking of flag changes (consider a dedicated flag_history table).
  • Your team lacks PHP/Laravel expertise (steepness of bitwise learning curve).

How to Pitch It (Stakeholders)

For Executives: "This package lets us store dozens of boolean attributes (e.g., user permissions, feature toggles) in a single database column, slashing storage costs and speeding up queries. For example, instead of 10 is_admin, is_premium columns, we’d use one UNSIGNED BIGINT—cutting database size by 90% and improving API response times. It’s a low-risk, high-reward optimization for scalable systems like [Product X], with minimal dev overhead."

For Engineering: *"BinaryFlags gives us a clean, Laravel-native way to handle bitwise flags via traits or enums. Key benefits:

• Trait Integration: Add InteractsWithNumericFlags to Eloquent models for instant flag methods (e.g., user->toggleFlag(UserFlags::IS_ADMIN)).
• Type Safety: Enums (e.g., BinaryEnumFlags) prevent magic numbers and improve IDE support.
• Future-Proof: Supports 64-bit flags out of the box; upcoming v3.0.0 enforces stricter typing (int-only).
• Compatibility: Works with existing UNSIGNED BIGINT schemas—no schema migrations needed. Tradeoff: Requires understanding bitwise ops, but the trait abstracts 90% of complexity. Ideal for permission systems, feature flags, or product filters where boolean attributes are dense."*