Paw Mkt Dashboard

.pawbytes/marketing-suites/
├── dashboards/
│   └── launcher.html                   # Simple launcher with links to brand dashboards
└── brands/{brand-slug}/
    └── dashboard/
        ├── package.json
        ├── svelte.config.js
        ├── vite.config.ts
        ├── postcss.config.js           # Empty — prevents parent config inheritance
        ├── src/
        │   ├── app.html
        │   ├── app.css                 # Tailwind directives + design tokens
        │   ├── lib/
        │   │   ├── server/
        │   │   │   └── db.ts           # sql.js singleton + schema + seed data (single module)
        │   │   ├── utils/
        │   │   │   └── markdown.ts     # Markdown-to-HTML renderer (server-side)
        │   │   └── components/         # Reusable Svelte components (LLM-generated)
        │   │       ├── Sidebar.svelte
        │   │       ├── DataTable.svelte
        │   │       ├── Modal.svelte
        │   │       ├── StatusBadge.svelte
        │   │       └── EmptyState.svelte
        │   └── routes/
        │       ├── +layout.svelte      # Dashboard shell (sidebar + main)
        │       ├── +layout.server.ts   # Load nav items + brand info
        │       ├── +page.svelte        # Overview / home
        │       ├── +page.server.ts     # Load summary stats
        │       ├── campaigns/
        │       │   ├── +page.svelte    # Campaign list + CRUD
        │       │   └── +page.server.ts # Load + form actions
        │       ├── content/
        │       │   ├── +page.svelte
        │       │   └── +page.server.ts
        │       ├── strategy/
        │       │   ├── +page.svelte
        │       │   └── +page.server.ts
        │       ├── documents/
        │       │   ├── +page.svelte        # Document index — all discovered .md files
        │       │   ├── +page.server.ts     # Load document list from db
        │       │   └── [slug]/
        │       │       ├── +page.svelte    # Rendered markdown (read-only)
        │       │       └── +page.server.ts # Load + render single document
        │       └── api/
        │           └── export/
        │               └── +server.ts  # JSON export endpoint
        └── data/
            ├── dashboard.db            # SQLite database file (gitignored)
            └── export/                 # JSON exports for git commits

## Headless Mode

When `--headless` or `-H` is passed:

1. Skip conversational discovery prompts
2. Discover all brands automatically
3. Present a generation plan (brands found, features to generate, output paths) — but **do not write any files**
4. Output the plan to stdout as JSON and wait for confirmation

**Files are never written in headless mode without explicit opt-in.** To allow automatic writes, pass `--auto-approve` alongside `--headless`. Without `--auto-approve`, headless mode exits after outputting the plan and requires the user to re-run with `--auto-approve` or proceed interactively.

> **Consistency with Saving Protocol:** The Saving Protocol applies in all modes. `--auto-approve` is the explicit grant of write permission; absent that flag, confirmation is always required before any file is created or modified.

## Path Resolution

**Launcher:** `{project-root}/.pawbytes/marketing-suites/dashboards/launcher.html`

**Brand dashboards:** `{project-root}/.pawbytes/marketing-suites/brands/{brand-slug}/dashboard/`

**Database:** `{project-root}/.pawbytes/marketing-suites/brands/{brand-slug}/dashboard/data/dashboard.db`

## Escalation Routes

| Signal | Routes To |
|--------|-----------|
| Missing brand workspace | paw-mkt-setup — configure the module first |
| Need SOSTAC plan before tracking | paw-mkt-sostac — build the strategy first |
| Campaign content creation | paw-mkt-content, paw-mkt-launch, etc. |
| Analytics tracking setup | paw-mkt-analytics |
| Conversion optimization | paw-mkt-cro |

## Output Contract

Every dashboard generation includes:

- **Brands discovered:** Count and names of brand workspaces found
- **Schema designed:** Tables and fields generated per brand
- **Dashboards created:** Paths to generated SvelteKit project
- **Run instructions:** How to install and start the dashboard
- **Export instructions:** How to export JSON for git commits

## Generated Dashboard Capabilities

| Feature | Description |
|---------|-------------|
| **Full CRUD** | Add, edit, delete records via form actions — instant reactivity |
| **Filtering & search** | Server-side filtering via URL params |
| **Status indicators** | Semantic color badges (not gradient accents) |
| **Relationships** | Foreign key dropdowns (campaign → channels, etc.) |
| **Bulk actions** | Multi-select for batch operations |
| **Export** | SQLite → JSON files for git commits |
| **Import** | JSON → SQLite for restoring data |
| **Responsive** | Works on desktop and mobile |
| **Progressive enhancement** | Forms work without JavaScript |
| **Documents** | Read-only rendered markdown of all discovered brand workspace files |