# plugin-admin

`@fayz-ai/plugin-admin` · preview · Partial capability

Every SaaS/admin-template app already resolves a shell config — sidebar or topbar layout, rail or tabs for module navigation, a mobile header treatment, whether org/branding settings are shown — from FayzAppConfig (src/config/app.tsx / theme.ts) at build time. Today an operator can't see any of that from the Panel; changing it means hand-editing config files and redeploying. plugin-admin adds an…

## Specs

- **Package:** `@fayz-ai/plugin-admin`
- **Version:** 0.1.0
- **Status:** preview
- **Capability:** Partial capability
- **Product type:** Platform
- **Stable channel:** not published yet
- **Migrations:** none
- **Factory:** `createAdminPlugin()`

## Data model

No tables of its own — this plugin uses the core / archetype library (same rule: tenant_id + RLS)..

## AI tools

| id | mode | description |
| --- | --- | --- |
| `admin.get-shell-settings` | read | Returns the app shell configuration: layout variant, module nav style, mobile header treatment, and whether org/branding settings are shown. |

## Integrations

No hosted connector — external providers come in via the connector spine (`@fayz-ai/core`).

## Integrate

Add the plugin to surfaces.admin.plugins in your app's app.manifest.json and run the doctor to validate:

```json
{ "surfaces": { "admin": { "plugins": [ { "id": "admin", "enabled": true } ] } } }
```

```bash
npx fayz doctor
```