@jmruthers/pace-core 0.5.126 → 0.5.128

package/docs/rbac/super-admin-guide.md

@@ -260,7 +260,45 @@ function FilteredDataTable() {
 }
 ```
 
-## 8. Navigation Guards
+## 8. PaceAppLayout Super Admin Bypass
+
+When using `PaceAppLayout` with `enforcePermissions={true}`, super admins automatically bypass all permission checks:
+
+```tsx
+import { PaceAppLayout } from '@jmruthers/pace-core';
+
+function App() {
+  return (
+    <UnifiedAuthProvider supabaseClient={supabase} appName="My App">
+      <Router>
+        <Routes>
+          <Route path="/" element={
+            <PaceAppLayout 
+              appName="My Application"
+              enforcePermissions={true}
+              defaultPermission="read"
+            />
+          }>
+            <Route index element={<HomePage />} />
+            <Route path="dashboard" element={<DashboardPage />} />
+            <Route path="organisation/:orgSlug" element={<OrganisationPage />} />
+          </Route>
+        </Routes>
+      </Router>
+    </UnifiedAuthProvider>
+  );
+}
+```
+
+**Key Features:**
+- Super admins bypass all permission checks automatically
+- No strict mode violations logged for super admins
+- Page name extraction: nested routes like `/organisation/scouts-victoria` use `"organisation"` as the page name
+- Custom page IDs can be provided via `pageIdMapping` prop
+
+**Note:** PaceAppLayout checks super admin status before enforcing permissions, ensuring super admins can access any route without violations or access denied errors.
+
+## 9. Navigation Guards
 
 Protect entire routes for super admins:
 
@@ -303,7 +341,7 @@ function AdminRoutes() {
 }
 ```
 
-## 9. Environment-Specific Configuration
+## 10. Environment-Specific Configuration
 
 You can also check for super admin access in your environment configuration:
 
@@ -321,7 +359,7 @@ const appConfig = {
 };
 ```
 
-## 10. Best Practices
+## 11. Best Practices
 
 ### ✅ Do:
 - Always check `isSuperAdmin` first for performance
@@ -336,7 +374,7 @@ const appConfig = {
 - Skip permission checks assuming super admin status
 - Use anon key for super admin operations
 
-## 11. Testing Super Admin Access
+## 12. Testing Super Admin Access
 
 ```tsx
 import { render, screen } from '@testing-library/react';
@@ -373,7 +411,7 @@ test('shows regular content for non-super admin users', () => {
 });
 ```
 
-## 12. Practical Examples
+## 13. Practical Examples
 
 ### Basic Super Admin Check
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jmruthers/pace-core",
-  "version": "0.5.126",
+  "version": "0.5.128",
   "description": "Clean, modern React component library with Tailwind v4 styling and native utilities",
   "private": false,
   "publishConfig": {

package/src/components/Button/Button.tsx

@@ -74,7 +74,7 @@ function getButtonClasses(variant: ButtonProps['variant'] = 'default', size: But
     outline: 'border border-main-300 bg-background shadow-sm hover:bg-acc-400',
     secondary: 'bg-sec-100 text-sec-900 shadow-sm hover:bg-acc-400',
     ghost: 'hover:bg-acc-400',
-    link: 'text-primary underline-offset-4 hover:underline text-shadow-md hover:text-shadow-accent',
+    link: 'text-main-700 underline-offset-4 hover:underline hover:drop-shadow-lg hover:drop-shadow-acc-400',
   };
   
   const sizeClasses = {