🔐 Introducing ngx-smart-permissions – Lightweight Role & Permission Handling for Angular Apps

Managing access control in Angular apps shouldn't be complicated. That's why I built:

👉 ngx-smart-permissions

A lightweight, smart Angular library that lets you control access using roles and permissions, with clean APIs and full support for Angular 17 & 18.

---

🌟 Why ngx-smart-permissions?

Whether you're building an admin dashboard, an enterprise portal, or a CMS — managing permissions should be simple, declarative, and testable.

This library helps you:

• ✅ Show/hide UI elements based on permissions or roles
• ✅ Use powerful directives like *ngxHasPermission, *ngxHasRole
• ✅ Protect routes using permission-based guards
• ✅ Enable Super Admin override
• ✅ Handle lazy-loaded modules
• ✅ Work seamlessly with both NgModules and Standalone Components

---

🔧 Installation

npm install ngx-smart-permissions

---

⚙️ Usage Example

✅ UI Permission Check

<button *ngxHasPermission="'edit-post'">Edit</button>

✅ Role-based Check

<div *ngxHasRole="'admin'">Admin Area</div>

🔐 Route Guard Example

{
  path: 'dashboard',
  canActivate: [permissionGuard],
  data: { permission: 'view-dashboard' }
}

---

🚀 Live Permission Switching

permissionService.switchPermissions(['edit-users', 'view-dashboard'], true, 'admin');

Great for dynamic role switching and testing environments!

---

🌐 Try it Live

• 📘 GitHub: ngx-smart-permissions
• 💻 Demo App: ngx-smart-permissions-demo

---

👨‍💻 About the Author

Hi, I'm Rami Shaikha, a passionate Angular developer and OSS contributor.

Would love your feedback, stars ⭐, or even contributions if this library helps you.

---

❤️ Support & Feedback

If you're using Angular and want clean, scalable access control — give it a try!

Open to suggestions, improvements, or just a 👋 in the comments.

---

🏷 Tags

#angular #typescript #webdev #opensource #frontend #authorization #accesscontrol